3 minute read

Ensure link text is descriptive

Imagine seeing only the links on your web page and nothing else. If they all said “Read more”, where would they go?

Some people skip through a web page using only the links, that’s one of the key functions of a screen reader. Let them know where those links lead, without assuming the surrounding text context.

Why descriptive link text matters

The purpose of link text is to clearly communicate where the link will take the user or what action it will trigger. Non-descriptive or vague link text can be confusing and frustrating.

  • Improves navigation: Screen readers can navigate links independently, reading only the link text. Vague links like “Click here” don’t tell users where they lead, causing confusion.
  • Makes usability better: Clear, descriptive links help all users quickly understand what to expect, making for a smoother browsing experience.
  • Supports SEO: Descriptive links give search engines context, improving discoverability while keeping accessibility as the main focus.
  • Meets accessibility standards: WCAG emphasizes descriptive link text, making it both a legal and ethical practice for accessible content.

Best practices for writing descriptive link text

1. Describe the destination or action

Link text should describe where the link goes or what it does.

  • Be specific: Replace vague text like “Click here” with specific phrases, such as “Read our accessibility guidelines” or “Download the annual report (PDF).”
  • Reflect the link’s purpose: This helps users know what to expect and makes navigation easier.

2. Avoid generic link text

Generic link text can confuse users, especially if multiple links use the same phrase but lead to different destinations.

  • Use unique, descriptive links: If you have several links, ensure each one is specific, e.g., “Product details” instead of “Click here.”
  • Ensure links make sense out of context: For example, “Accessibility resources” is clearer than “Click here for more information.”

3. Keep link text concise

Link text should be descriptive yet brief. Long, wordy links are harder to read and navigate.

  • Aim for brevity: Try to keep link text under 8–10 words.
  • Remove unnecessary words: For example, “Read our accessibility blog” is clearer than “View our latest blog post on accessibility.”

4. Use contextual language

Link text should fit naturally within the surrounding content.

  • Make links flow within sentences: For example, “Read our guide on accessibility standards” is clearer than “Our guide on accessibility standards is available here.”
  • Explain the connection to related content: A phrase like “Learn how to create accessible content” is more informative than “Learn more.”

5. Indicate file types and sizes

If a link downloads a file (e.g., PDF or PowerPoint), indicate the file type and size.

  • Specify the file type: For example, “Download the report (PDF)” or “View slides (PPT).”
  • Show file size for large downloads: For instance, “Download the annual report (PDF, 2MB).”

6. Test your links for accessibility

Testing ensures that links work well for all users.

  • Use a screen reader: Listen to how links are read aloud to identify any unclear text.
  • Keyboard navigation: Tab through links to check if they’re easily navigable and the focus order makes sense.
  • Gather user feedback: If possible, ask users with disabilities to evaluate link clarity and usability.

Examples of descriptive link text

  • Before: “Click here”
  • After: “Read our latest article on web accessibility”
  • Before: “More info”
  • After: “Learn more about our accessibility features”
  • Before: “Download”
  • After: “Download the annual report (PDF, 2MB)”

Further reading

Previous articleNext article
Back to top