Start scanning free

( Robust / WCAG 4.1.2 )

ARIA role is invalid

This check maps to Name, Role, Value. Use the guidance below to confirm the issue, understand who it affects and ship a fix.

Critical Level A WCAG 4.1.2 — Name, Role, Value

What’s wrong

An element has a role attribute with a value that is not a valid WAI-ARIA role.

Why it matters

Assistive technologies use ARIA roles to understand what an element is and how to interact with it. An invalid role is ignored or causes unpredictable behaviour — the screen reader may announce the element incorrectly or not at all.

How to fix it

Use only valid WAI-ARIA roles. The best fix is usually to use the correct native HTML element instead.

Before
<div role="buton">Click me</div>
<div role="container">...</div>
<nav role="navigation-menu">...</nav>
After
<button>Click me</button>
<div role="region" aria-label="Featured content">...</div>
<nav aria-label="Main navigation">...</nav>

Learn more