Fix guide · Links with no text

How to fix “Links must have discernible text”

By · Updated

A link on the page has nothing a screen reader can read out: no text, no alt on its image, no label. Give every link words that say where it goes, either visible text, alt text on the image inside it, or an aria-label.

axe rule
link-name
WCAG
2.4.4 Link Purpose (In Context) (Level A) and 4.1.2 Name, Role, Value (Level A)
Lighthouse
Google Lighthouse and PageSpeed Insights report it as “Links do not have a discernible name”

What it means

"Discernible text" means a name a screen reader can announce. An icon link, a link wrapped around an image with no alt, or an empty link left behind by a page builder all fail it. A screen reader then says just "link", or reads out the web address.

The WebAIM Million found empty links on 46.3% of home pages in 2026. Social media icons in headers and footers are a very common cause.

Who it affects

People who use a screen reader, and people who use voice control, who say a link's name to click it.

How to find it

  1. Run the free checker. It lists each link with its code and where it points, which usually tells you which icon or image it is.
  2. Look at your header and footer first: social icons, a phone or email icon, a cart icon, a search icon.
  3. Look for blog or product cards where only the picture is a link.

How to fix it

  1. If the link holds an image, give the image alt text that says where the link goes.
  2. If the link is an icon only, add text a screen reader can read. Visible text is best. If the design can't have it, use an aria-label on the link, or text that's hidden visually but kept for screen readers.
  3. If the link is empty and does nothing, remove it.
  4. Make the name say where it goes. "Facebook" or "Our Facebook page" works. "Click here" said ten times on one page doesn't.

A social icon

Before · fails
<a href="https://facebook.com/samplebakery">
  <svg aria-hidden="true">...</svg>
</a>
After · fixed
<a href="https://facebook.com/samplebakery" aria-label="Sample Bakery on Facebook">
  <svg aria-hidden="true">...</svg>
</a>

A card where only the photo is linked

Before · fails
<a href="/blog/overtime-pay/"><img src="overtime.jpg"></a>
After · fixed
<a href="/blog/overtime-pay/"><img src="overtime.jpg" alt="Read: What to do if you aren't paid overtime"></a>

From a real fix

On the law firm site I fixed in October 2026, the blog listing wrapped each post's photo in a link with no alt text, so those cards announced as just "link". Using each post's title as its photo's alt text fixed them.

In your website builder

Where each platform’s own help pages cover it, as of November 2026. Menus move, so follow the link if a step doesn’t match what you see.

WordPress
For the Social Icons block, select each icon and set its Text. Turn on Show text if you want it visible. For an image that's a link, set the image's Alternative text. WordPress help
Wix
Buttons have an Accessible name field under Settings. Use it for any button shown as an icon only. Wix help
Webflow
Select the link and add a custom attribute named aria-label in the Element settings panel. Webflow help

Questions people ask

Is "Read more" a problem?

Not for this rule, since it is text. W3C's link purpose criterion lets the surrounding sentence or card give the context. It's still kinder to say "Read more about overtime pay", because screen reader users often pull up a list of links on their own.

What a scanner can and can’t tell you

Fixing this clears one automated check. It doesn’t mean the page is accessible, and it doesn’t settle any legal question. Automated tests catch only part of the problems. W3C puts it plainly: evaluation tools “can not determine accessibility, they can only assist in doing so.” The rest takes a person working through the site with a keyboard and a screen reader.

Source: W3C WAI, Selecting Web Accessibility Evaluation Tools. Not legal advice.

Sources

All checked November 8, 2026. The rule wording is axe-core 4.14.0’s own.

Related fixes

Every fix guide →

Check a page for free

Scan any page of your site against WCAG 2.1 AA in about 30 seconds. You get the problems automated testing finds, in plain words, with a link to a fix guide for the common ones.

Run the free checkno sign up · one page at a time

Rather have someone fix it for you? Tell me about your site.