Skip to content
Learn Measure Blog Case studies About
On this page
  • How the Lighthouse link text audit fails
  • How to add descriptive link text
  • Link text best practices
  • Resources

Links do not have descriptive text

May 2, 2019 — Updated Aug 21, 2019
Available in: Español, 日本語, 한국어, Português, Русский, 中文, English
Appears in: SEO audits
On this page
  • How the Lighthouse link text audit fails
  • How to add descriptive link text
  • Link text best practices
  • Resources

Link text is the clickable word or phrase in a hyperlink. When link text clearly conveys a hyperlink's target, both users and search engines can more easily understand your content and how it relates to other pages.

How the Lighthouse link text audit fails #

Lighthouse flags links without descriptive text:

Lighthouse audit showing links don't have descriptive text

Lighthouse flags the following generic link text:

  • click here
  • click this
  • go
  • here
  • this
  • start
  • right here
  • more
  • learn more
Each SEO audit is weighted equally in the Lighthouse SEO Score, except for the manual Structured data is valid audit. Learn more in the Lighthouse Scoring Guide.

How to add descriptive link text #

Replace generic phrases like "click here" and "learn more" with specific descriptions. In general, write link text that clearly indicates what type of content users will get if they follow the hyperlink.

<p>To see all of our basketball videos, <a href="videos.html">click here</a>.</p>

Don't

"Click here" doesn't convey where the hyperlink will take users.

<p>Check out all of our <a href="videos.html">basketball videos</a>.</p>

Do

"Basketball videos" clearly conveys that the hyperlink will take users to a page of videos.

You'll often need to revise the surrounding sentence to make link text descriptive.

Link text best practices #

  • Stay on topic. Don't use link text that has no relation to the page's content.
  • Don't use the page's URL as the link description unless you have a good reason to do so, such as referencing a site's new address.
  • Keep descriptions concise. Aim for a few words or a short phrase.
  • Pay attention to your internal links too. Improving the quality of internal links can help both users and search engines navigate your site more easily.

See the Use links wisely section of Google's Search Engine Optimization (SEO) Starter Guide for more tips.

Resources #

  • Source code for Links do not have descriptive text audit
  • Search Engine Optimization (SEO) Starter Guide
Last updated: Aug 21, 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.