How to fix aria dialog name on Wix

Steps for Wix

1. In the Wix Editor, click on the popup/lightbox element on your canvas (or go to Add → Lightbox to review existing lightboxes in the Pages & Lightboxes panel).
2. Wix does not expose raw HTML editing for standard editor elements, so use Wix's Velo (Dev Mode) to patch ARIA attributes via JavaScript.
3. Enable Velo: go to the top menu → Dev Mode → Enable Velo.
4. In the Velo code panel, use the $w API in the page code or a masterPage.js file: $w('#myLightbox').onViewportEnter(() => { const el = document.querySelector('[role="dialog"]'); if (el) el.setAttribute('aria-label', 'Newsletter signup'); });
5. Alternatively, use the Velo wixWindow.openLightbox callback and a MutationObserver to patch the attribute when the lightbox opens.
6. Preview the site, open the lightbox, and use the axe DevTools browser extension to confirm the dialog now has an accessible name.

<div role="dialog" aria-modal="true" aria-labelledby="cart-dialog-title">
  <h2 id="cart-dialog-title">Your Shopping Cart</h2>
  <!-- dialog content -->
</div>

<!-- OR, when no visible heading exists -->
<div role="dialog" aria-modal="true" aria-label="Newsletter signup">
  <!-- dialog content -->
</div>

What is aria dialog name?

Any time your store shows a popup, modal, or overlay — such as a cookie notice, quick-view product panel, cart drawer, age-verification gate, or newsletter signup — that element needs an accessible name. An "accessible name" is a short label that screen readers announce when the dialog opens, telling the user what the popup is for. It is provided either by pointing to a visible heading inside the dialog (aria-labelledby) or by writing a brief label directly on the element (aria-label). Without one, screen-reader users land in the dialog with no context about its purpose.

Screen readers used by blind and low-vision shoppers announce the accessible name of a dialog the moment it opens. Without a name, a user hears only "dialog" — with no indication of whether it is a cart, a promo, a warning, or something else — making the popup effectively unusable. This violates WCAG 2.1 Success Criterion 4.1.2 (Name, Role, Value), which is a legal requirement under the ADA, the European Accessibility Act, and similar laws in many countries. Beyond legal risk, an inaccessible checkout or cart modal directly reduces conversions among the estimated 7–8 % of online shoppers who rely on assistive technology. Fixing this also benefits keyboard-only users and voice-control software that rely on the same label.

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