Link descriptions, which are the clickable words in links, help users and search engines better understand your content. Lighthouse flags any links with non-descriptive text:
What causes this audit to fail
Lighthouse flags the following generic link descriptions:
How to add descriptive link text
Replace generic descriptions, such as
click here in the example below:
<p>To see all of our basketball videos, <a href="videos.html">click here</a>.</p>
…with specific descriptions, such as
basketball videos in the example below:
<p>Check out all of our <a href="videos.html">basketball videos</a>.</p>
In general, the link text should clearly indicate to users what type of content they'll get if they click the link.
Learn more in Add descriptive link text.
Link text guidelines
- Stay on topic. Don't use 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.
- Format links so that they're easy to spot.
- Pay attention to your internal links, too. Improving the quality of internal links can help users and Google navigate your site easier.
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. Java is a registered trademark of Oracle and/or its affiliates.