Inserting links

There are two types of link selector in the New CMS. Each behaves slightly differently, so it is important to make sure you understand how to use both.

On

1. Link selector in the Editor

The Editor is the main way to edit the body text on many Content types - including Basic, News story and Student profile.

To add a link to body text in the Editor, first select the text you'd like to link from and press the link icon. The Editor link selector will pop up.

To link to a page within this CMS from the Editor:

  • the link selector is an autocomplete lookup field - start typing the page name or a word from the URL
  • all pages in the New CMS are indexed in the lookup, so be sure you choose the right one
  • results from the Group you're currently working in will appear at the top
  • the page you select is then shown as a /node/xxx URL
  • after saving, the actual URL is displayed below the link selector box.

Information displayed for each link in the selector includes:

  • Group name
  • URL of page
  • Content type
  • Date the page was last updated
  • Entity ID number
  • Published status: a green tick (✅) for published and a red exclamation mark (❗️) for unpublished

To link to a page outside this CMS from the Editor:

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.

To link to an email address from the Editor:

Paste or type the entire email address into the link selector box. The New CMS should recognise you have put in an email address and allow you to confirm this. This will automatically add a special mailto: prefix to ensure that browsers recognise the link as an email address.

How to link to a file from the Editor

Important: Never paste a link directly into the Editor. This is because pasted links will bypass our link verification and have an increased chance of being broken. Always use the link button instead

The new link lookup provides more detailed information about your links

2. Single field link selector

Single fields links are the main way to insert a link in on many Content types - including Home, Hub and related links on Basic - and in many Components.

To link to a page within this CMS in the single field link selector:

  • the link selector is an autocomplete lookup field - start typing the page name or a word from the URL
  • all pages in the New CMS are indexed in the lookup, so be sure you choose the right one
  • results from the Group you're currently working in will appear at the top
  • to narrow down your search, type a word from the URL. For example to find the CBE undergraduate courses page you would type 'cbe courses'

Information displayed for each link in the selector includes:

  • Group name
  • URL of page
  • Content type
  • Entity ID number
  • Published status: a tick (✅) for published and an exclamation mark or cross (❗️) for unpublished

To link to a page outside this CMS in the single field link selector:

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.

To link to an email address in the single field link selector:

Type mailto: into the link field followed by the email address. For example:

mailto:cms@sheffield.ac.uk

The mailto: prefix will ensure that browsers recognise the link as an email address.

How to link to a file from a single field link

Single field link selector
Single field link selector

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


3. Links in your site's menu

Your site's local navigation menu is located in your CMS Group's 'Edit' tab.

Within the 'Edit' tab you will see a 'Section navigation' heading. Click the reusable paragraph's Edit button, which will open an editable list of the menu links. The links can be added, edited and removed using the Editor link selector.

See also: Add a page to the local navigation menu


Tips

  • 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

  • Never paste a link directly into the Editor

  • If the link selector brings page names and very little further information then there could just be a temporary problem. Save the page you're editing and go back in to try again

  • To link to the main University homepage, just type / in the link selector. Some pages will be suggested by the lookup - just ignore these and either click save (link selector in the Editor) or click outside of the suggestions list (single field link selector).

  • 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 paste in a link beginning https://cms.shef.ac.uk

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

  • Remember to write useful link text for each link. Avoid 'click here' and 'read more' if you can. Instead, your link text should consisely describe where the link leads


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.