How to fix “Links must have discernible text”
By Justin Zagar · 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
- 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.
- Look at your header and footer first: social icons, a phone or email icon, a cart icon, a search icon.
- Look for blog or product cards where only the picture is a link.
How to fix it
- If the link holds an image, give the image alt text that says where the link goes.
- 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.
- If the link is empty and does nothing, remove it.
- 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
<a href="https://facebook.com/samplebakery">
<svg aria-hidden="true">...</svg>
</a><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
<a href="/blog/overtime-pay/"><img src="overtime.jpg"></a><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
- Buttons must have discernible text
Buttons with no text
- Images must have alternative text
Images without alt text
- Elements must have their visible text as part of their accessible name
Visible text doesn't match the name
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.
Rather have someone fix it for you? Tell me about your site.