Methodology
Button accessible names
ia.button-names · 3.13
Act
SHOULD
Recommendation
Why it matters
AI agents invoke buttons by their accessible name in the accessibility tree. Without a discernible name, an AI agent cannot identify what a button does, making form submission and page interaction impossible.
How to fix it
Give each button a text or an aria-label.
-
Add visible text to each button, or an aria-label for icon buttons.
<button type="button" aria-label="Close dialog"><svg aria-hidden="true">...</svg></button>
Verify
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.button-names
Details Mapping, lifecycle and references
- AR mapping
- No AR practice
- Evidence source
- WCAG Name, Role, Value
- Score role
- Core
- Introduced
- 2026-08-24
- Methodology version
- 2026-10-22