Start scanning free

( Robust / WCAG 4.1.2 )

ARIA attribute has an invalid value

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 ARIA attribute has a value that is not valid for that attribute — for example, aria-expanded="yes" instead of aria-expanded="true".

Why it matters

Assistive technologies read ARIA attribute values to understand component state. An invalid value is treated as if the attribute doesn’t exist, producing unpredictable behaviour — a user may be told a menu is collapsed when it’s open.

How to fix it

Use the correct enumerated values. Most boolean ARIA attributes accept only "true" or "false".

Before 
<button aria-expanded="yes">Menu</button>
<div aria-hidden="1">...</div>
<input aria-required="required">
After 
<button aria-expanded="true">Menu</button>
<div aria-hidden="true">...</div>
<input aria-required="true">

Learn more