- Where to find it
- Labelled Links in the "Selected Component" section of the Modify drawer.
- Offered by
- The Text 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 where you make part of your text clickable. It is a numbered list: the first link you add is number 1, the second is number 2, and so on. Nothing becomes clickable just because you added it here — you also have to say which words it applies to, over in Content Text.
Most of the time you will not add entries here by hand. Linking words from the Content Text toolbar creates the entry for you and points those words at it; you come here afterwards to give it a name, open it in a new tab, or change the address.
You do that by wrapping those words in the link's number. Type Read our {1|pricing} page in Content Text, add a link at number 1 pointing to /pricing, and the word "pricing" becomes the link while the rest of the sentence stays ordinary text. Two links in one sentence is just {1|…} and {2|…}.
Each entry has one thing that really matters — the address — and a handful of optional refinements. The address can be a page on your own site (/pricing), a full web address (https://example.com/plans), an email link (mailto:sales@example.com), a phone link (tel:+15551234567), or a jump to somewhere further down the same page (#faq). RuleCMS does not insist on a particular shape, because plenty of perfectly good links do not look like a website address at all.
The Name field is worth filling in even though visitors never see it. It is the only thing telling you which entry is which when you come back in three months and the list has six numbered addresses in it.
The rest are refinements you will use occasionally. Where it opens decides between the same tab and a new one. Screen reader text replaces the linked words for people using a screen reader, which is how you rescue a link that reads only "click here". Relationship, Language of the destination, What the destination is told, and the download toggle are for the specific situations described under each field.
When you would use it
- A sentence of body copy where two or three words should take the reader somewhere.
- A heading that doubles as a link to the section it introduces.
- A "contact us" phrase that should open the reader's email or phone app.
- A call to action that has to go somewhere different on phones than on desktop.
How to change it
- Click the text component on the canvas.
- In the Modify drawer, open "Selected Component", then "Links".
- Press "Add link", fill in the Link address, and give it a Name so you can recognise it later.
- Open "Content Text" and wrap the words you want clickable in that link's number, like {1|pricing}.
- Uncheck "Same value for all resolutions" if a link should differ per device.
Watch out for
- Deleting an entry leaves an empty numbered slot behind, and that is deliberate. Your text refers to links by number, so closing the gap would slide link 3 into position 2 and silently repoint every {2|…} you have already written — including on pages that are already published. The empty slot holds the number open. Only a slot at the very end of the list can be removed outright.
- A number in your text with no matching link simply shows as plain text. Nothing breaks and no empty link is published, so a marker pointing at a slot you emptied stops linking rather than pointing somewhere wrong. That also means a typo in the number looks like nothing happened.
- Choosing "New tab" adds rel="noopener noreferrer" for you. That is a small security measure preventing the page you opened from interfering with yours, and you do not need to type it into the Relationship field yourself.
- The link wraps the words, not the block. A linked phrase inside a heading makes the words clickable, not the heading's padding, and that is on purpose: the alternative causes real problems for screen readers and can break the page as it loads. If you want a whole card or banner to be clickable, that belongs on the row or column, not here.
- Addresses beginning javascript:, vbscript:, data:, file: or blob: are removed when the page is published. The editor warns you rather than refusing the edit, but the published link will do nothing.
- Link colour and underline are not set here. They come from the Typography settings on the column, or from the styling of the site the widget is embedded in.
Related settings
For developers
The technical reference for what this setting produces: MDN: the anchor element. You do not need any of it to use the setting — it is there for whoever is building the components or debugging the published page.
Where to go next
- Back to the Text component — everything else it can do.
- The Composer — the editing surface these settings live in.
- Publishing — how a change like this reaches your live site.