Start scanning free

( Robust / WCAG 4.1.2 )

Dialog or modal has no accessible name

This check maps to Name, Role, Value. Use the guidance below to confirm the issue, understand who it affects and ship a fix.

Serious Level A WCAG 4.1.2 — Name, Role, Value

What’s wrong

A dialog is shown without an accessible name via aria-label or aria-labelledby.

Why it matters

Screen reader users need a clear dialog title when focus moves into a modal. Without a name, they cannot tell which task context just opened.

How to fix it

Use semantic HTML and valid ARIA so assistive technology gets the same state and structure as sighted users. Keep labels and states explicit in markup.

Before
<div role="dialog">
  <p>Are you sure?</p>
</div>
After
<div role="dialog" aria-labelledby="confirm-title">
  <h2 id="confirm-title">Delete project</h2>
  <p>Are you sure?</p>
</div>

If this pattern is generated by a component, fix it once in the shared component so every instance inherits the accessible behavior.

Learn more