Operable
2.5.3 Label in Name
When a control has a visible label, its name in the code has to contain that same text, so speech users can say what they see.
Who it helps
Speech input users.
Failures we see most
- A button that shows "Search" but is named "Submit query" in code
- Links with aria-labels that differ from their visible text
How it gets tested
Our scanner runs this axe-core check for 2.5.3:
| Check | What it looks for |
|---|---|
label-content-name-mismatch | Elements must have their visible text as part of their accessible name |
Automated checks can find failures of 2.5.3, but they cannot confirm that a page passes. A specialist still reviews it by hand.
How we fix it
A specialist fixes this in your site's code or content, and we re-test the page before you sign off.
Official text: W3C, Understanding 2.5.3 Label in Name. Checks listed from axe-core 4.14.0.
Related criteria
Does your site fail 2.5.3?
Our free scan checks up to 50 of your pages and tells you which criteria fail and where.