Inserting links

How to use the link selectors to choose a destination page for your link.

Select your text

In the Editor select the text you'd like to link from and press the link icon. This link selector will pop up.

Linking to pages within the CMS - Body content field

  • The link selector is an autocomplete lookup field. Type the name of an existing page and choose what to link to from the resulting list. Note that all pages in the new system currently show up, so be sure to choose the relevant one for your website. 

  • The page you’re linking to is then shown as a /node/xxx URL.

  • After saving, the actual URL is displayed below the link selector box.

Important: When linking to a page in the CMS, always use the automatic page lookup, instead of pasting a full URL. This will prevent links from breaking when the source page gets updated.

Linking to pages within the CMS - Improved link selector tool

The new link lookup provides more detailed information about your links

The improved link selector functionality provides more detailed information about your searched for links than the current link selector tool in the body content field; making choosing the correct link, first time, that much easier.

Information displayed includes:

  • Group name
  • URL of page
  • Content type
  • Date the page was last updated
  • Entity ID number
  • Published status. A green tick for published. A red exclamation mark for unpublished.
  • Results from the group you're currently working in will appear at the top.

In the URL field search for your page via its name or URL (web address) and then click the Save button.

Linking to an email address

When linking to an email address, paste the entire email address into the link selector box. A special "mailto:" prefix will be automatically added by the system making sure that browsers recognise the link as an email address. You shouldn't manually add the 'mailto:' prefix.

Linking outside of the CMS

For pages outside of the CMS - such as an old CMS page or external website - you can paste the full web address of the page into the link selector box and must include the http:// or https:// prefix.

Check your links

You can check the destination link

  • by clicking the actual URL displayed below the link selector box

  • from the Editor: Command-left click (Mac) or Windows-left click (PC) to open the link in a new window

  • from the page preview window


  • When linking to a page in the CMS, use the link selector lookup instead of pasting a full URL.

  • When linking to a page outside the CMS, include the http:// or https:// part of the web address when pasting it into the link selector.

  • Never paster in a link beginning

  • Always double check your links on the live site after publishing. You could even use a tool like this broken link checker.

Related links

Related links are optional links you can add to the bottom of the Basic and News story content types

  • Related links are turned on by default but don't appear unless at least one entry is added.
  • You can optionally edit the title of the related information section. It defaults to Related information.
  • Related links must be added using the link selector. Learn how to insert links.
  • Add link text in the link text field.
  • Click the Add another item button to add another link.
  • Use the drag and drop feature to position links in the preferred order.

Next step

Create a page tutorial

Get in touch

If you have CMS questions or are stuck then get in touch and we'll do our best to help.