How to fix: “Links must have discernible text”
Links with no text, explained in plain English, with the exact fix and code you can copy.
- Scanner rule:
link-name- Standard:
- WCAG 2.4.4 Link Purpose (In Context) (Level A), WCAG 4.1.2 Name, Role, Value (Level A)
What this error means
Every link needs a name that tells people where it goes. A link with only an icon or image and no text, label or alt, has no name. A screen reader announces it as 'link' and nothing more, so the person has no way to know whether it leads to Facebook, your cart or your home page.
Empty links appeared on 46.3% of home pages in the WebAIM Million 2026 report. Source: WebAIM Million
Who it affects
Screen reader users, voice-control users (who say the name of a link to click it), and anyone who navigates by tabbing through the links on a page.
Where it usually hides
- Social media icons in the header or footer
- A logo that links to the home page, built as a background image
- Cart, search and account icons
- Cards or product tiles where the whole card is a link but the only content is an image
- Empty links left behind by a page builder or an editing mistake
How to fix it
- Find the flagged link in the scan report, or in Chrome by pressing Tab through the page and watching which focus box has no readable label.
- If the link has room for text, add visible text. That is the best fix because it helps everyone.
- If it must stay an icon, add an aria-label that says where the link goes: 'Facebook', 'View cart', 'Acme Dental home'.
- If the link contains an image, give that image an alt that describes the destination. If it contains an SVG icon, add aria-hidden="true" to the SVG so the label is not read twice.
- Delete links that have no content and no purpose.
Before and after
Before
<a href="https://facebook.com/acmedental">
<svg viewBox="0 0 24 24">...</svg>
</a>An icon-only link: announced as just 'link'.
After
<a href="https://facebook.com/acmedental" aria-label="Acme Dental on Facebook">
<svg viewBox="0 0 24 24" aria-hidden="true">...</svg>
</a>The aria-label gives the link a name; aria-hidden stops the icon being announced too.
On your website platform
WordPress, Shopify, Wix and Squarespace
Social icon blocks and header icons are usually generated by your theme or a plugin. Check the block or widget settings for a 'label' or 'alt text' field. If there is none, a small theme or plugin edit adds the aria-label, or contact the theme's support with the exact error.
Common mistakes
- Adding a title attribute instead of aria-label. Title is not reliably announced.
- Labeling every link 'click here' or 'read more'. Each link's name should make sense out of context.
- Hiding the label with display:none, which hides it from screen readers too. Use a visually-hidden class instead.
How to check your fix
- Re-run a scan and confirm the link issue is gone.
- Press Tab through the page. For every link, ask whether someone hearing only its name would know where it goes.
- In Chrome DevTools, open the Accessibility tab, select the link, and read the 'Name' field. It must not be empty.
Is this on your site?
Run a free scan and see every page and element affected. No account needed.
Questions people ask
What is a 'discernible' name?
Text a screen reader can read aloud: visible link text, an aria-label, an image alt inside the link, or visually hidden text.
Is an empty link a legal problem?
It is one of the failures that accessibility complaints commonly cite, because it is easy to detect automatically. It is also quick to fix.
Keep reading
- Buttons with no label: Buttons must have discernible text
- Images with no alt text: Images must have alternative text
- Links only distinguished by color: Links must be distinguishable without relying on color
- The accessibility mistakes we see on almost every small business site
Automated scans catch only part of what WCAG covers, and fixing a scan result is not a legal guarantee of compliance. Last reviewed November 16, 2026.