How to fix aria dialog name on Wix

Steps for Wix

1. Open the Wix Editor for your site.
2. Wix generates dialogs (lightboxes) via Add → Lightbox. Click on the lightbox component to select it.
3. Open the lightbox settings panel. In the Accessibility section (if available in your plan), enter a descriptive name in the 'ARIA label' field.
4. If no ARIA label field is available, add a prominent text element at the top of the lightbox that serves as a heading — Wix's accessibility engine will use it as the accessible name in many cases.
5. For custom coded dialogs in Velo (Wix's dev platform), open the page code, locate the dialog element, and set element.accessibility.ariaLabel = 'Your dialog name'; or element.accessibility.ariaLabelledBy = headingElement.
6. Publish the site and verify with 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.