How to fix aria dialog name on WooCommerce

Steps for WooCommerce

1. Identify which plugin or theme generates the dialog: common sources are WooCommerce core (mini-cart drawer), popup plugins (e.g., Elementor Popup, Ninja Popups), or your theme (e.g., Storefront, Flatsome).
2. For theme-generated modals, go to Appearance → Theme File Editor (or use a child theme) and locate the template file rendering the dialog (e.g., header.php, woocommerce/cart/mini-cart.php).
3. Add a unique id to the dialog's heading and add aria-labelledby="that-id" to the element with role="dialog"; or add aria-label="Mini cart" if no heading exists.
4. For plugin-generated popups, check the plugin's settings for an 'Accessibility' or 'ARIA label' field; if none exists, add the attribute via a small JavaScript snippet in Appearance → Customize → Additional CSS/JS or in your child theme's functions.php using wp_add_inline_script.
5. Clear any caching plugins (e.g., WP Rocket, W3 Total Cache) and verify with a screen reader or axe 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.