Skip to content
Convertto

ARIA Roles Reference

Search ARIA roles with their required attributes, native HTML equivalents and gotchas.

ARIA roles tell assistive technology what an element is when the HTML does not. This reference lists 30 common roles with the native HTML element that already provides each one, the attributes the role requires to work, and the mistake most often made with it — including that an unnamed section or form is not a landmark at all.

Runs in your browser
Privacy
Runs entirely in your browser — nothing is uploaded
Cost
Free, unlimited, no sign-up

Frequently asked questions

Should I add ARIA roles to my HTML?

Usually not. The first rule of ARIA is not to use ARIA — a native <button> already has role="button", keyboard handling and focus behaviour, while role="button" on a div gives you only the label and leaves you to build the rest.

Why is my role="menu" navigation not working well?

Because role="menu" describes an application menu, like the File menu in a desktop app, with arrow-key navigation and a single tab stop. Site navigation should be a <nav> containing a plain list of links.

How to use the aria roles reference

  1. 1Enter or paste your search.
  2. 2Choose the category.
  3. 3The result appears immediately — copy or download it.

Embed this tool

Put the working aria roles reference on your own site. It runs in your visitors' browsers exactly as it does here — free, no account, nothing uploaded.

Share this tool

Related tools

HTML Landmark CheckerCheck a page for the landmark regions screen reader users navigate by.Alt Text CheckerFind images with missing, empty, filename-based or overlong alternative text.Heading Structure ValidatorCheck a page for skipped heading levels, missing or multiple H1s and empty headings.Link Text CheckerFind vague link wording — "click here", "read more", bare URLs and duplicated labels.Palette Accessibility GraderGrade every colour in a palette against one or more backgrounds for WCAG contrast.Touch Target Size CheckerCheck whether a button or link meets the minimum tap target size and spacing.

Last updated

More accessibility