A link is not a URL typed into a field somewhere. It is its own document under Resources → Links that navigation, the footer, the category menu and every CTA button reference. Edit the link and every place using it updates. The button text is not part of the link, each section supplies its own label; the link decides where clicking it goes and how it opens.
Creating one starts with picking a destination type:
| Type | What it points to |
|---|---|
| Internal | A page in this CMS, picked from a list |
| Custom URL | Any address, external sites or hand-written paths |
| An email address, opens the visitor's mail app | |
| Phone | A phone number, starts a call on tap |
| File | An uploaded image, for linking straight to the asset |
Internal links are the default and the safest: they follow the page even if its slug changes later. Reach for Custom URL only when the target lives outside the CMS.
Below the destination sit three smaller panels. Behavior controls opening in a new tab and how search engines treat the link. Performance controls prefetching, which is off by default, leave it unless a developer asks. Accessibility holds an optional ARIA label and title for assistive technology.
Two admin-only fields at the end. Internal name is how you find the link again, name it like you would a file, "Footer newsletter CTA" beats "Click here". The list title is derived automatically from the internal name or the destination, so an unnamed link still shows something readable.
The editor only shows settings that make sense for the chosen type, and switching type cleans up the rest on save. An email link keeps no new tab setting, an internal link keeps no phone number.
Deleting is quiet. Remove a link and every button using it simply stops rendering, no error, no broken href, just a missing button. There is no usage list to warn you, so when a destination changes, edit the existing link instead of deleting and recreating it. Everything pointing at it comes along for free.