How to fix: Button has no readable name
Button has no readable name is a common WCAG A accessibility failure that automated scanners flag and that EAA enforcement authorities take seriously. Here is what triggers it, why it matters, and the concrete fix.
Why it matters and how to fix it
An icon-only button with no text or aria-label is silent to assistive tech. WCAG 4.1.2 (Name, Role, Value) requires every control to expose its name programmatically.
Add visible text inside the button or set an aria-label that names the action.
Re-run the scanner after the fix to confirm zero violations on this rule. Add a unit or e2e test that asserts the relevant attribute is present so the issue cannot regress silently.
Guidance, not legal certification
Scan results are automated accessibility guidance, not legal advice or a certified conformance opinion. Always pair an automated scan with manual expert review.
Frequently asked questions
Will my site be fined just for this issue?
Single issues are rarely fined directly. Authorities usually require remediation within a deadline; ignoring the notice can lead to administrative fines.
How does the scanner detect this?
We run axe-core rules against the rendered page and surface every violation with the matching WCAG criterion and the impacted DOM selector.
