---
title: "Invalid ARIA attribute name (a11y/aria-valid-attr)"
description: "a11y/aria-valid-attr: Browsers ignore misspelled aria-* attributes (aria-labeledby, aria-role), so the label or state never reaches assistive technology."
canonical: https://void-design.vercel.app/rules/a11y/aria-valid-attr
lastModified: 2026-09-16
---

# Invalid ARIA attribute name

`a11y/aria-valid-attr` · severity **error** · category Accessibility · detected by `void a11y` and `void audit`

## Why it matters

Browsers ignore misspelled aria-* attributes (aria-labeledby, aria-role), so the label or state never reaches assistive technology.

## How to fix it

Correct the attribute name to one defined in WAI-ARIA, such as aria-labelledby or aria-describedby.

## References

- https://dequeuniversity.com/rules/axe/4.13/aria-valid-attr

## 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-attr` Required ARIA attribute is missing — [a11y/aria-required-attr](https://void-design.vercel.app/rules/a11y/aria-required-attr)
- `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-value` Invalid ARIA attribute value — [a11y/aria-valid-attr-value](https://void-design.vercel.app/rules/a11y/aria-valid-attr-value)
- `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 <body> — [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)

Detected by `void a11y` and `void audit`. Explain it in a terminal: `void rules a11y/aria-valid-attr`
