Contents

Component Name

The name your developer registered for this component in the app.

Where to find it
Labelled Component Name in the "Selected Component" section of the Modify drawer.
Offered by
The Custom Component component. Other components do not have this setting.
Per device
Yes — you can set one value for every screen, or separate values for phone, tablet, and desktop.

In plain English

This is the handshake. Your developer registers a component in the website under a name — booking-form, pricing-calc, waitlist. You type that same name here. When the two match, the real component appears on the published page.

The name is not a guess and it is not a search. There is no list to pick from, because RuleCMS cannot see what is in your app. It has to match exactly, including hyphens. booking-form and bookingForm are different names.

Ask your developer for the name in writing and copy it. Do not rename it to something friendlier — the app will not find a name it was not registered under.

In the editor the dashed box updates to show this name. That is all the editor can show. The real component appears only on the site that registered it.

When you would use it

  • Whenever your developer has given you a name to type here. Without that name, Custom is an empty slot.
  • A different name on phones than on desktop, if they registered both — a compact booking form on small screens and the full one on large ones.

How to change it

  1. Get the exact name from your developer. Copy it; do not retype it from memory if you can help it.
  2. Click the Custom component on the canvas.
  3. In the Modify drawer, open "Selected Component", then "Component Name".
  4. Paste the name. It must start with a letter. After that: letters, numbers, hyphens, and underscores only, up to 64 characters.
  5. Uncheck "Same value for all resolutions" only if a different registered component should appear on phones or tablets.
  6. Publish, then check the live page. If you still see the box with this name in it, the spelling does not match the app. Check with your developer before changing anything else.
One value, or one per device? Every input in this setting sits under a “Same value for all resolutions” checkbox. Leave it checked for a single value everywhere, or uncheck it to give phones, tablets, and desktops their own. How per-device values work.

Watch out for

  • A typo shows the named box on the live site instead of the component. Check the spelling with your developer before anything else.
  • The name must start with a letter. Spaces, dots, and a name that starts with a number are refused.
  • Leaving it empty publishes an empty slot. The box on the live page will say "Custom Component" and nothing will appear inside it.
  • Changing the name after publish is a new handshake. The old registration does not follow a rename. Your developer has to register the new name, or you have to change it back.
  • A name that works on your staging site and fails in production usually means production has not been deployed with that registration yet. That is an app release, not a RuleCMS setting.

Related settings

Where to go next