--- title: "Invalid ARIA attribute value (a11y/aria-valid-attr-value)" description: "a11y/aria-valid-attr-value: Invalid values (e.g. Use a value the attribute allows (true or false, a token, a number), and make id references point at…" canonical: https://void-design.vercel.app/rules/a11y/aria-valid-attr-value lastModified: 2026-09-16 --- # Invalid ARIA attribute value `a11y/aria-valid-attr-value` · severity **error** · category Accessibility · detected by `void a11y` and `void audit` ## Why it matters Invalid values (e.g. aria-expanded="yes", aria-controls pointing at nothing) are ignored or misannounced. ## How to fix it Use a value the attribute allows (true or false, a token, a number), and make id references point at elements that exist. ## References - https://dequeuniversity.com/rules/axe/4.13/aria-valid-attr-value ## More accessibility rules `void a11y` reports 48 rules in this category. WCAG 2.2 AA through axe-core, plus checks axe can't do alone: visible keyboard focus, 24/44px target size on mobile, 320px reflow and disabled zoom. - `aria-required-children` ARIA role is missing required children — [a11y/aria-required-children](https://void-design.vercel.app/rules/a11y/aria-required-children) - `aria-required-parent` ARIA role is missing its required parent — [a11y/aria-required-parent](https://void-design.vercel.app/rules/a11y/aria-required-parent) - `aria-roles` Invalid ARIA role — [a11y/aria-roles](https://void-design.vercel.app/rules/a11y/aria-roles) - `aria-valid-attr` Invalid ARIA attribute name — [a11y/aria-valid-attr](https://void-design.vercel.app/rules/a11y/aria-valid-attr) - `aria-hidden-focus` Focusable element inside aria-hidden — [a11y/aria-hidden-focus](https://void-design.vercel.app/rules/a11y/aria-hidden-focus) - `aria-hidden-body` aria-hidden on — [a11y/aria-hidden-body](https://void-design.vercel.app/rules/a11y/aria-hidden-body) - `aria-command-name` ARIA button/link/menuitem has no accessible name — [a11y/aria-command-name](https://void-design.vercel.app/rules/a11y/aria-command-name) - `aria-input-field-name` ARIA input field has no accessible name — [a11y/aria-input-field-name](https://void-design.vercel.app/rules/a11y/aria-input-field-name) Detected by `void a11y` and `void audit`. Explain it in a terminal: `void rules a11y/aria-valid-attr-value`