Insert a link

You can add links to pages, files, or documents inside or outside your Sitecore site. Links can be added in:

• the Rich Text Editor
• a text field that includes a link toolbar
• components that provide link fields

These are the three types of link actions you can perform:

• Insert an internal link
• Insert an external link
• Edit or remove a link

Note: select Lock and Edit to check out and edit the page.

Accessibility requirement: Use descriptive link text

Link text must clearly describe the destination or action. Avoid vague phrases like “click here” or “read more.” Review the accessibility standards for descriptive links section.

Examples

• Renew your driver’s license
• Download the application form
• How to publish in Sitecore

Add an internal link

Internal links are preferred because they automatically update if the page moves.

Add an internal link in the Rich Text Editor

1. Highlight the text you want to hyperlink.
   
   
2. Click the Insert Sitecore Link icon .
3. In the Insert Link box, use the content tree to find your page (or choose the media tab if linking to an image or file in the media library).
   
   
4. Click Insert.
5. Click Accept at the bottom of the Rich Text Editor box.
6. Save your changes.
7. Select the Unlock icon to check on your page if you are done editing.

To change the link, clear the link by clicking the broken link icon, then follow the same steps above.

 

Add an internal link from a text field

1. Highlight the text.
2. A toolbar will appear. Click the Link icon .

• Follow the same steps covered above.

NOTE: To remove the link you must use the rich text editor.

 

Add an internal link inside a component

Many components include built‑in link fields. Use these instead of adding links inside component text fields.

How to add a link inside a component

1. Open the component from the folder in the Content Editor.
2. In the Content area look for a field labeled "Link".
3. Click Insert Sitecore Link.
4. Navigate to and choose the internal page.
5. Save  your changes.
6. Select the Unlock  icon to check on your page if you are done editing.

Note: Do not add links inside the component's rich text editor if you can avoid it. This keeps layouts consistent and avoids accessibility issues.

 

Add an external link

Use external links only when the destination is outside your Sitecore site.
 

1.  Highlight the text you want to link.
   
2. Click the Hyperlink Manager icon .
   
3. Fill out the following fields:
   
   • URL - Enter the full website address (example: http://www.google.com)
   • Link Text - Populated with highlighted text
   • Target - Same Window
   • Leave the other fields blank.
4. Click OK.
5. Click Accept.
6. Save your changes.
7. Click the Unlock icon in the Home tab in the ribbon to check on your page if you are done editing.

To change the link, follow the same steps.

✅ Reminder: Check external links often to make sure they still work.

 

Remove an internal link (Rich Text Editor only)

1. Highlight the linked text you want to remove the link from.
2. Click the Remove Link icon .
3. Click Accept.
4. Save  your changes.
5. Select the Unlock  icon to check on your page if you are done editing.

 

Remove external link

1. Highlight the linked text you want to remove the link from.
2. Click the Remove Link icon and the link will be removed from the text.
3. Click Accept.
4. Save your changes.
5. Select the Unlock icon to check in your page if you are done editing.
   
   

✅ Best practices

• Only link to pages that exist.
• Use clear, descriptive link text like “How to Publish in Sitecore” instead of vague phrases like “click here.”
• Use internal links when possible - they're safer and update automatically.