How to fix aria dialog name on Webflow

Steps for Webflow

1. In the Webflow Designer, click on the modal/dialog element in the Navigator panel to select it.
2. Open the Element Settings panel (the gear icon on the right) and scroll to the Custom Attributes section.
3. If the dialog has a visible heading inside it: give the heading element an HTML id (e.g., modal-title) via its own Custom Attributes, then add the attribute aria-labelledby with value modal-title to the dialog wrapper element.
4. If there is no visible heading, add the attribute aria-label with a descriptive value (e.g., 'Newsletter signup') directly to the dialog wrapper element.
5. Publish the site and confirm the fix using the axe DevTools browser extension.

What is aria dialog name?

Any popup, modal, or overlay that uses `role="dialog"` or `role="alertdialog"` must have an accessible name — a short label that tells users what the dialog is for. This name is provided either by pointing to the dialog's own heading with `aria-labelledby`, or by writing the label directly into an `aria-label` attribute on the dialog element itself. Without it, a screen reader user hears something like "dialog" with no context when the popup opens, giving them no idea whether it's a cart, a cookie notice, a sign-in prompt, or anything else.

Screen reader users — including many people with visual impairments — rely entirely on the announced name of a dialog to orient themselves when it opens. A nameless dialog is effectively invisible to them: they may not know a popup has appeared, what it contains, or how to close it, which can block them from completing a purchase or any other task. This violates WCAG 2.1 Success Criterion 4.1.2 (Name, Role, Value) at Level A — the most basic level of conformance — creating real legal exposure under the ADA (US), EN 301 549 (EU), and equivalent laws in many other countries. Fixing it also signals to Google that your site is well-structured, and it prevents cart-abandonment from users who cannot interact with a broken modal (e.g., a checkout popup or cookie consent dialog).

See the complete Aria dialog name guide for every platform and the full background.