Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Link text must be descriptive and give the reader an idea of where they will be taken if they click on it. Links visually stand out to readers because they are coloured blue. Poorly written link text can hurt website usability, accessibility and SEO (search engine optimization). Help users get to where they want to be faster by describing the destination. Here are some tips for writing effective link text: 

  • Be descriptive . - Do not use vague language such as “click here” or “learn more” because it doesn’t provide context for users and makes it more difficult for people who use assistive technology to navigate web content using links. Your links should be descriptive so that it is clear what people can expect if they click on them. Descriptive hyperlinks can also improve your content's search rankings. 

  • Match link text to the source or keywords. - Describe the destination page or file that the link goes to. Match the link text to the source page title where possible. In some instances, the source page title won’t be descriptive enough or is just too long, but the closer you are to a match, the better.  

  • Avoid linking punctuation. - Sometimes links are added at the end of a sentence with some type of punctuation. As a best practice, put the punctuation outside the linked text. 

  • Do not use full URLs as link text . - Don’t use full URLs, such as “httpshttps://www.toronto.ca”ca, or worse: “httpshttps://www.toronto.ca/business-economy/business-operation-growth/business-support/.  When we see “httpshttps://www.toronto.ca”ca, we see the word 'Toronto', but a screen reader is going to read the full URL letter-by-letter, including https, colon, slash and www. It also makes your copy less cluttered for users reading the text visually. It is acceptable in some situations to use a vanity URL such as “torontotoronto.ca/business”. An example:

  • Ensure content is compliant with AODA legislation.  

  • Read the AODA legislation to ensure content is compliant. Click here.  

  • Read the AODA legislation to ensure content is compliant: https://www.ontario.ca/page/how-make-websites-accessible.

    business. 

...

...

...

  • Links pointing to:

    • other pages on toronto.ca – open in the same window.

    • web pages outside of toronto.ca – open in a new window.

    • documents such as PDFs, Word or Excel files – open in a new window.

  • The link label must describe the destination page or file that the link goes to and not use vague language such as “click here” or “learn more”.

  • Avoid creating pages that are just lists of links (a.k.a. “link farms”) because pages should provide service-oriented information and context.

  • Links to applications that help users perform a transaction can be made in the following ways:

    • Linked text

    • Linked text within a Highlight

    • Call to Action feature – button only

    • Action button

    • Tile menu

  • City applications under toronto.ca/…should open in the same window. Non-City applications and websites should open in a new window.

  • In some cases, an intermediate page may be needed or recommended (for example, to provide additional context or accept terms and conditions)

Be strategic about where you place a link on a page and how many links you provide. Placing too many links on a page can cause users to exit the page without reading important information or can discourage them from completing a task. 

...