Empty Link: What the Error Means and How to Fix It
Also called: Link without text, Link has no accessible name, Unnamed link
Definition
An empty link is a link element that has no accessible name – no text, no alt text on an image inside it and no aria-label. Screen readers can only announce it as a bare link, so users cannot tell where it leads.
An empty link is a link with no accessible name: there is no text inside it that a screen reader can read out. Accessibility scanners report it as "Empty link" or "Link has no accessible name". It almost always comes from icon links, logo links and image links whose picture has no text alternative.
What it means
Every link needs a name that tells people where it goes. Sighted visitors see a shopping cart icon and understand it. A screen reader finds no text and announces only "link" or reads out the web address. Someone who browses by listening, or who pulls up a list of all links on the page, hears a row of unnamed links and has to guess.
The rule behind it is WCAG 2.4.4 Link Purpose (In Context), a Level A criterion of WCAG 2.2: the purpose of each link must be clear from the link text alone or together with its programmatically determined context (the same sentence, list item or table cell). An empty link has no text at all, so it fails before context is even considered. W3C lists "not providing an accessible name for an image which is the only content in a link" as a common failure (F89). Because links are interface components, an unnamed link also fails 4.1.2 Name, Role, Value.
| Cause | Why the link is empty | Fix |
|---|---|---|
| Image link without alt | The image has no text alternative | Add an alt text that names the target |
Image link with alt="" |
Empty alt hides the only content | Write a real alt text |
| Icon font or SVG only | Icons carry no text | Add aria-label or visually hidden text |
| Link with no content | Leftover <a> from a template or slider |
Remove it or give it text |
Examples
Typical empty links are social media icons in the footer and a logo in the header. The missing alt attribute is often the real cause.
<!-- Empty link: icon only, no name -->
<a href="/cart"><svg aria-hidden="true">…</svg></a>
<!-- Fixed: accessible name with aria-label -->
<a href="/cart" aria-label="Shopping cart"><svg aria-hidden="true">…</svg></a>
<!-- Fixed: image link with descriptive alt text -->
<a href="/"><img src="logo.svg" alt="Example Shop home page"></a>Give every icon or image link a short name for its destination – via alt text on the image, an aria-label, or visually hidden text. Delete links that have no content and no purpose.
Rely on a title attribute alone, set alt="" on the only image inside a link, or use names like "icon" or "click".
How to fix an empty link
If your site runs on a CMS, icon links usually come from the theme or a menu block. In WordPress, check the navigation and social icon blocks first.
Questions
What does "empty link" mean in an accessibility report?
It means a link has no accessible name. A screen reader cannot announce where it goes, so it reads only "link" or the URL.
Is an empty link a WCAG violation?
Yes. It fails 2.4.4 Link Purpose (In Context) and 4.1.2 Name, Role, Value, both Level A. That makes it relevant for laws based on WCAG, such as the European Accessibility Act.
Does a title attribute fix an empty link?
Not reliably. W3C treats title as a supplement to link text, and many screen readers and touch devices ignore it. Use visible text, alt text or aria-label.
How do I find empty links on my website?
Run the free WCAG scanner on your homepage. It lists empty links together with other errors such as an empty button.
Can allyWay fix empty links automatically?
Yes. allyWay finds unnamed links on every page and gives them clear names that screen readers can read aloud, written by AI from your page content. The automatic fixes are applied by the allyWay script, so your CMS, theme and files stay as they are – and every fix is logged. Start for free and see how many empty links allyWay fixes on your site.
Related terms
Missing Alt Attribute: Error Explained and Fixed
A missing alt attribute means an img element (or an image button or image map area) has no alt attribute at all. Assistive technology cannot tell whether the image is informative or decorative and may read out the file name instead.
Read definition: Missing Alt Attribute: Error Explained and FixedEmpty Button: What the Error Means and How to Fix It
An empty button is a button element with no accessible name – no text, no aria-label and no alt text on an image inside it. Screen readers announce only that it is a button, not what it does.
Read definition: Empty Button: What the Error Means and How to Fix ItAlt text
Alt text is a short written description of an image. Screen readers read it aloud, and browsers show it when the image can't load – so people who can't see the image still get its meaning.
Read definition: Alt text