Links must have discernible text

Rule link-name · Links & buttons · impact serious · Static + live

↩ Back to the rules index · WCAG cross-reference

Why it matters#

A link with no accessible name (e.g. an icon-only or image link with no alt) is announced as "link" with no destination, and is useless to screen-reader and speech users.

How to fix#

Provide text inside the link, alt text on a link image, or aria-label describing where the link goes.

Example#

<a href="/profile"><svg aria-hidden="true"></svg></a>

<a href="/profile" aria-label="Your profile"><svg aria-hidden="true"></svg></a>

Example#

<a href="/article"></a>

<div aria-hidden="true"><a href="/article" tabindex="-1">Read article</a></div>

Links inside an aria-hidden subtree (e.g. cloned carousel slides) are out of the accessibility tree and are not checked here.

WCAG success criteria#

2.4.4 Link Purpose (In Context) — Level A#

The purpose of each link should be clear from its text (or its programmatically-associated context).

Understanding 2.4.4

4.1.2 Name, Role, Value — Level A#

Every UI component must expose a correct name, role, and (where relevant) state/value to assistive technology.

Understanding 4.1.2

Standards#

This rule contributes to the following standards:

WCAG A EN 301 549 Section 508 Trusted Tester ACT

References#

• WCAG — Link Purpose