Skip to content

Rule · Accessibility

Link has no accessible name

a11y/link-nameerrorvoid a11yupdated

Why it matters

Links without discernible text (e.g. icon links) are announced only as "link".

How to fix it

Add link text, aria-label, or alt text on the image inside the link.

Example

tsx
<a href="https://github.com/org" aria-label="GitHub"><svg aria-hidden="true">…</svg></a>

References

void a11y reports 48 rules in this category. WCAG 2.2 AA through axe-core, plus checks axe can't do alone: visible keyboard focus, 24/44px target size on mobile, 320px reflow and disabled zoom.