Rule library ARIA

ARIA dialog and alertdialog nodes should have an accessible name

aria-dialog-nameBest practice

Ensure every ARIA dialog and alertdialog node has an accessible name

Who this affects

A dialog or alertdialog has no accessible name, so its purpose is not announced when it opens.

How to fix it

Add aria-label, or point aria-labelledby at the dialog's heading.

Effort Low · ~10 min

How to check it by hand

Inspect the element in the browser's accessibility tree — the Accessibility panel in Chrome or Firefox DevTools. Compare the computed role, name and state with what a sighted user sees. Where they disagree, the ARIA is wrong. Native HTML is almost always the safer fix.

Automated testing settles roughly a third of the WCAG success criteria. This rule is one an automated tool detects reliably — but a clean automated result is not proof of conformance.

Reference

Deque's technical write-up for this rule: aria-dialog-name

See whether your site trips this rule

Paste a URL. We open it in a real browser, dismiss the cookie wall and run the full EN 301 549 rule set. No account, no card.

Run a free scan All rules