Skip to content
Learn Measure Blog Case studies About
On this page
  • How this Lighthouse audit fails
  • How to add accessible names to links
  • Resources

Links do not have a discernible name

May 2, 2019 — Updated Sep 19, 2019
Available in: Español, 日本語, 한국어, Português, Русский, 中文, English
Appears in: Accessibility audits
On this page
  • How this Lighthouse audit fails
  • How to add accessible names to links
  • Resources

Link text that is discernible, unique, and focusable improves the navigation experience for users of screen readers and other assistive technologies.

How this Lighthouse audit fails #

Lighthouse flags links that don't have discernible names:

Lighthouse audit showing links do not have discernible names
The Lighthouse Accessibility score is a weighted average of all the accessibility audits. See the Lighthouse accessibility scoring post for more information.

How to add accessible names to links #

Similar to buttons, links primarily get their accessible name from their text content. Avoid filler words like "Here" or "Read more"; instead, put the most meaningful text into the link itself:

Check out <a href="…">our guide to creating accessible web pages</a>.
</html>

Learn more in Label buttons and links.

Resources #

  • Source code for Links do not have a discernible name audit
  • Links must have discernible text (Deque University)
Last updated: Sep 19, 2019 — Improve article
Return to all articles
Share
subscribe

Contribute

  • File a bug
  • View source

Related content

  • developer.chrome.com
  • Chrome updates
  • Web Fundamentals
  • Case studies
  • Podcasts
  • Shows

Connect

  • Twitter
  • YouTube
  • Google Developers
  • Chrome
  • Firebase
  • Google Cloud Platform
  • All products
  • Terms & Privacy
  • Community Guidelines

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies.