Skip to content
aulys.app · accessibility 100read the statement
Aulys

WCAG 2.5.3 · Level A

What is WCAG 'label in name' (2.5.3)?

A control's accessible name must contain the visible text label. WCAG 2.5.3 (Level A) ensures that what a sighted user reads on a button matches what a voice-control user must say to activate it.

What it is

Label in name requires the programmatic name of a control to include its visible text.

Why it matters

Voice-control users speak the visible label to operate a control. If the accessible name differs, the command fails.

How to fix it

  1. 01Make sure the accessible name starts with, or contains, the exact visible text.
  2. 02Avoid hiding the visible label from the accessible name with aria-label overrides that drop words.
  3. 03Keep icon-only buttons' names matched to any adjacent visible text.

How Aulys catches it

Aulys flags controls whose visible label and intended accessible name diverge, so voice control keeps working.

Scan your first frame free