Adding a Hyperlink to Your Content (NEW)

Modified on Mon, 25 Aug at 1:29 PM

Hyperlinking best practices

Before adding a document or web link, consider the clarity, accessibility, and user-friendliness of the text you’re hyperlinking. Well-written link text helps users understand where a link will take them and ensures your content is accessible to everyone, including screen reader users.

Avoid vague link text

To meet accessibility standards, it's recommended to avoid vague or generic link text such as:

Read more...
Learn more...
Click here...

These phrases lack context when encountered by screen readers or assistive technologies. Link text should ideally clearly convey the destination or purpose of the like without the surrounding context.

Keep link text short and meaningful

Clearly describe what the user can expect. For example:

Tax Tips for Investors
View Our 2025 Market Report

Indicate the file type when linking to documents

This helps users know it will open or download a document, especially if the file is a downloadable format like a PDF:

Tax Tips for Investors (PDF)
Download: 2025 Market Report (PDF)

Indicate external links

Let users know when they are being taken to a different website. You can do this in two common ways:

Inline: Visit the Digital Agent website (external)
Visual/Icon: Digital Agent website ↗

Adding a hyperlink to your content

1. While in the Web Content Editor, select the text or image you’d like to add a hyperlink to and click the For hyperlinking icon to open the Link window.

2. In the Link window, add in your URL.

What is Alt Text for links?

The Alt Text field may be used to provide an invisible label (also called the ARIA label) for an element when:

The element has no visible text, such as an icon-only button or link.
A custom label is needed for accessibility but should not be shown on screen.

However, writing clear and descriptive link text should always take priority over relying on alt text or ARIA labels. Alt text should only be used in specific situations—such as when the link is represented solely by an icon, or when the visible text lacks context on its own.

Remember: Avoid using generic phrases such as "click here" or "read more" as these do not provide meaningful context.

3. When you are finished editing your link, click Insert.

4. Your text should now display with the added hyperlink in the web content editor.

5. While your cursor is within your link text, you can select the Link button again to edit or remove the hyperlink.

6. Click Save as Draft or Submit for Approval to finish editing and view your content on the draft page.