Skip to main content
Understandable WCAG 2.5.3

Label in Name

The accessible name of a component must include its visible text. If a button says 'Search', its aria-label can't be 'Find items'. Voice control users say what they see.

In plain terms

A control's hidden name should match its visible label, so people using voice control can say what they see to click it.

Why this matters

Voice-control users say the visible label to activate a control. If a button reads 'Search' but its programmatic name is 'Find', saying 'click Search' does nothing — locking them out.

How to detect

Quick check

Compare each control's visible text to its accessible name (DevTools → Accessibility, or a screen reader). The visible words must appear within the accessible name.