2.5 Input Modalities · SC 2.5.3

A2 min read

Label in Name

For user interface components with labels that include text or images of text, the accessible name contains the text that is presented visually.

In plain language

The name a screen reader announces for a button or link must include the same text that's visibly written on it.

Why it matters

People who use speech-input software (saying "click Search" out loud) rely on the visible label matching the name in the code. If they don't match, voice commands fail, and screen reader users hear something different from what they see, which is confusing.

In practice

Fails this criterion

A button visibly says "Submit," but the code gives it the name "Send Form" for assistive technology. Someone saying "click Submit" through voice control can't activate it.

Meets this criterion

The same button's visible text ("Submit") and its accessible name match, so voice commands and screen readers refer to it the same way.

Test it yourself

Compare each button or link's visible text with what a screen reader announces for it (or check the accessible name in browser dev tools). If they don't match, this criterion is failing.

Read SC 2.5.3 on the official WCAG 2.2 specification ↗