Welcome Check Web

ARIA · WCAG 2.0 Level A

ARIA roles used must conform to valid values

Ensure all elements with a role attribute use a valid value.

What it means

The aria-roles rule flags elements that fail this check. It maps to WCAG success criterion 4.1.2.

Who it affects

Screen reader and voice control users, who depend on ARIA roles and attributes being valid.

How to fix it

Use only valid, non-abstract ARIA roles, spelled correctly.

<nav aria-label="Main">…</nav>

Check it on your site

Run a free scan. If this rule fails, the results list the affected elements. Deque, which maintains axe-core, also documents this rule in detail: Deque University: aria-roles.

Quick answers

What does the axe rule "aria-roles" check?

Ensure all elements with a role attribute use a valid value.

How do I fix "ARIA roles used must conform to valid values"?

Use only valid, non-abstract ARIA roles, spelled correctly.

Who is affected by aria-roles failures?

Screen reader and voice control users, who depend on ARIA roles and attributes being valid.

Automated accessibility scan. Results are informational and may not identify every accessibility issue. This service is not legal advice, a compliance certification, or a substitute for comprehensive manual accessibility testing.