Use these best practices for hyperlinks in web content. 

Hyperlink guidelines

Avoid long lists of links. Use headings to organize related links.

Be specific. Never write or link from generic or supporting text.

When linking to a PDF or other file type (DOC, XLS, CSV), write the file type and its size in brackets and include this in the link. Use the actual name of the document.

Use link text that gives the reader a clear call to action.

  • Open, view, read, download

Avoid linking blocks of text, long sentences or paragraphs.


  • Crown land is land (or land covered by water like rivers or lakes) that is owned by the provincial government

Not this:

Anchor links

Use anchor links at the top of an exceptionally long page. Keep in mind that pages with anchor links are often more difficult to update.

The names of anchor links should represent the content. Write anchor links in lower case and separate descriptive words with hyphens, not underscores.

  • #content-style-guide

Best practices

  • Make important links clearly visible
  • Use the Related Links right-coulmn box
  • Link to GUIDs rather than human readable URLs (the page picker tool links to GUIDs)
  • Be careful when linking to content that will expire or move (set a reminder)
  • Where possible, link to web pages rather than to files such as PDFs
  • Test and validate all links before publishing pages
  • Check your links regularly

See Content inventory and audit for how to prevent redundant, outdated and trivial (ROT) content.