Skip to main content
WCAG success criterion · Robust

4.1.2 Name, Role, Value

Guideline 4.1 Compatible. Level A, part of WCAG 2.0 and every later version.

ADA compliance guide

What this criterion requires

Every user interface component must expose its name, role, states and values to assistive technology, and notify it when they change. Native HTML elements do this automatically; custom components must do it via ARIA.

Who it helps

Screen reader and voice control users - without name and role, a control is announced as "clickable" or nothing at all.

Example: fails vs passes

Fails
<div class="dropdown" onclick="toggle()">Menu</div>
Passes
<button aria-expanded="false" aria-controls="nav-list" onclick="toggle(this)">Menu</button>

Name ("Menu"), role (button) and state (aria-expanded) - and update the state in JS when it changes.

How to meet and fix it

Common failures auditors find

Automated scanning catches a share of these instantly - run a free check - and a manual audit covers the judgement calls a tool cannot make.

In PDF documents

Interactive PDF form fields must expose name, role and value through the form dictionary and tags - buttons, checkboxes and radio groups included.

Check any document against this and 80+ more automated checks with the free PDF accessibility checker.

Sources

Last updated . Reviewed by the EqualWeb accessibility team.

Does your site pass 4.1.2?

Run a free automated check now, or have certified IAAP/CPWA auditors test every criterion and document the result.

Book a meeting Start Free Trial