Skip to content
Performance & Accessibility

How to Get Descriptive Link Text Right

Link wording that tells people where a link goes or what it does, such as "Download the 2026 price list", rather than "click here" or "read more".

Marcus Adeyemi Technical Director 2 min read 21 views
How to Get Descriptive Link Text Right

Where most projects go wrong

The usual mistakes:

  • Click here and read more as link text
  • Raw URLs as link text
  • The same text linking to different places
  • Images as links with no alt text

What good looks like instead

  • Write links that make sense on their own
  • Put the distinctive words at the start of the link
  • Name file type and size for downloads
  • Keep identical link text for identical destinations
  • Review card and teaser links for repeated wording
What to do and what to avoid with descriptive link text, side by side
Good practice against the usual mistakes, from the sources listed below.

Why it matters

Screen reader users often browse a list of links out of context, where repeated "read more" links are meaningless, and WCAG requires link purpose to be clear at level A.

The specs that matter

Published figures for Descriptive Link Text
MeasureFigure
WCAG 2.4.4 Link Purpose (In Context), Apurpose can be determined from the link text or its context
WCAG 2.4.9 Link Purpose (Link Only), AAApurpose is clear from the link text alone
Screen reader link listspresent links without the surrounding text
File linksshould state the file type and size

Knowing when to hand it over

Tip: Bring in help when a content library relies on generic link text, or when card components repeat the same link wording.

Where this comes from

The figures and practices above come from the sources listed.

Working on something like this?

We take on Performance & Accessibility work for teams who want it done once, properly. Tell us what you are building and we will tell you honestly whether we are the right studio for it. Start a project.

Where to go next

Spotted something wrong? Report an error on this page. We correct on the page and say what changed.

All services

The work behind this article, and what it costs.

Marcus Adeyemi

Builds and maintains the web work. Writes about front-end architecture, performance, accessibility and the unglamorous parts of keeping a site alive.

Keep reading

More in Performance & Accessibility