Document link guidelines

When writing copy for a document link, note the file type to tell users what will happen if they click the link. This guideline helps support accessibility tools for those using screen readers.

General best practices

The link copy should be written in this order:

  • Language (only note when document is translated into two or more languages)
  • Descriptive link text
  • File type

Link format if document is only translated in English: Descriptive link text (FILE TYPE)

Link format if document is translated in two or more languages: Language Descriptive link text (FILE TYPE)

Forms should be grouped by document (e.g., billing policy, financial assistance), then listed alphabetically within each group by language translation.

Language

  • Include the language translation of a document if a document is translated into two or more languages.
  • When used, language translation comes first in the link.

Link copy

  • For ADA compliance: Link copy must be descriptive and clear so users understand the content of the document before selecting it.
  • Use title case in the descriptive link copy when document link is in a list (e.g., Atrium Health Floyd Medical Center Financial Assistance Policy).
  • If the document link is within navigation or a sentence, normal style rules apply.

File type

  • The file type should be noted last in the link and written in uppercase inside parentheses. Examples: (PDF), (DOC), (PPT).
  • Links to documents must open in a new window.
  • Do not include "download" in the link copy. Most often documents open within the browser, giving users the option to download them. However, download is not the default option.

Document link examples

Use:

Do not use: