Deprecated ARIA roles

Last updated:

How to fix this issue?

Replace the deprecated role with the current equivalent. The most common deprecated role is directory, which was removed in WAI-ARIA 1.2:

<!-- Deprecated: role="directory" -->
<!-- Use role="list" instead -->
<ul role="list">
  <li>Item 1</li>
  <li>Item 2</li>
</ul>

Check the WAI-ARIA specification for the current list of deprecated roles and their recommended replacements.

Why is this important?

Deprecated ARIA roles were removed from the specification because they were redundant, ambiguous, or poorly supported. Using them risks inconsistent behavior across screen readers. Some assistive technologies may ignore the role entirely, leaving users without important semantic information.

Keep your ARIA usage up to date to ensure reliable support across all assistive technologies.

More info:

WCAG 4.1.2 Name, Role, Value.

Rule info

Standard

WCAG A SC 4.1.2

Regulations

EN 301 549 RGAA EAA AODA

User impact

Fix complexity

Was this article helpful?

Checkout the ExcellentWebCheck services

ExcellentWebCheck's goal is to improve the online user experience. The tools of ExcellentWebCheck help to detect and improve usability problems on your website.