Adding hyperlinks
Hyperlinks enable web pages to be dynamic, easily navigated and practical – they enable the user to jump, for instance, from one page to another page or from one location to another on the same page. The text format of a hyperlink distinguishes it from the main body of text; for instance, more often than not, hyperlink text appears blue and underlined. Additionally, when the mouse pointer is positioned over a hyperlink, the pointer typically changes into a hand icon and a pop-up box may appear describing the destination of the link. Within SilverStripe CMS you can create hyperlinks to a page on your site, a file or picture, an email address or an external web address.
- Click on the Site Content icon
to display the Site Content window - Locate or add the required page (for more information, refer to Finding a Page or Adding a Page)
- Click on the page in the My Site pane to display the contents and properties in the Edit Page pane
This is the page in which you will create the hyperlink… - Click on the Content tab in the Edit Page pane, then click on the Main sub-tab
- Select the text that will become the hyperlink

- Click on the Insert/edit link tool
This will display the link fields at the top of the “Edit Page” pane… - Select one of the options for Link to
The field located directly below the “Link to” option, identifying the linked item, will change depending on your selection. These options and the required follow-on action are described in the following table:
| “Link to” Option | Field Name below, changes to… | Action |
|---|---|---|
| Page on the site | Page | Click on the drop arrow |
| Another website | URL | Type in the address of the website that you want to link to. |
| Email address | Email address | Type in the email address that you want to link to. |
| Download a file | File | Click on the drop arrow |
In this example, “Page on the site” was selected…

8 Using the above table as a reference, either select or enter the details of the Link to item
This is the field located directly below “Link to”…
9 Type a brief description of the linked item in Link description
The text that you type into this field will be used as “hover text” – that is, when the user hovers the mouse pointer over the hyperlink, the description text will be displayed in a small pop-up box. It helps a user discern the destination of the hyperlink, thereby improving usability. Descriptions are also used by search engines and will achieve higher ratings…

10 Click on
to insert the link on the page
You will notice that the selected text, containing the hyperlink is now formatted blue…

Once the changes are saved and published, you can see the working hyperlink on the staging site…

