Methodology
Keyboard navigability
ia.keyboard-navigation · 3.11
Act
SHOULD
Recommendation
Why it matters
AI agents navigate pages using keyboard-style interactions via the accessibility tree. Positive tabindex values break natural focus order, and missing focusable elements on interactive widgets prevent AI agents from discovering and operating controls.
How to fix it
Remove positive tabindex values and make custom controls focusable.
-
Replace tabindex values above 0 with 0 or remove them.
-
Use native button and a elements, or add tabindex="0" and a role to custom controls.
<div role="button" tabindex="0">Open menu</div>
Verify
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.keyboard-navigation
Details Mapping, lifecycle and references
- AR mapping
- No AR practice
- Evidence source
- MDN tabindex
- Score role
- Core
- Introduced
- 2026-08-24
- Methodology version
- 2026-10-22