How to fix aria toggle field name on WooCommerce
Add a visible or programmatic accessible name to every toggle control (checkbox, switch, or button with role="switch") so screen readers can announce what the control does.
Steps for WooCommerce
- Access your WordPress Admin dashboard and go to Appearance → Theme File Editor (or use a child theme via FTP/SFTP).
- Search your theme's template files (especially header.php, footer.php, woocommerce/ overrides, and any page-builder shortcodes) for checkbox inputs or custom toggle markup.
- For each unlabelled checkbox, add a matching <label for="INPUT_ID">Descriptive text</label> or wrap both elements in a <label>.
- For icon-only switches (e.g. in mega menus or cookie plugins), add aria-label="Description" to the <button> or toggle element.
- If a plugin (e.g. a cookie consent or wishlist plugin) generates the unlabelled toggle, check the plugin's settings for an accessible label option, or contact the plugin developer. As a workaround, use a small Custom HTML block or a site-wide CSS+JS snippet via Appearance → Customize → Additional CSS / Custom JS plugin to inject the aria-label.
- Test using the axe DevTools browser extension or the WordPress Accessibility Checker plugin.
What is aria toggle field name?
WCAG Success Criterion 4.1.2 requires that every interactive control — including checkboxes, toggle switches, and any element with `role="switch"` — has an accessible name: a short text label that screen readers speak aloud when a user lands on the control. This label can come from visible text next to the element, an `aria-label` attribute, an `aria-labelledby` attribute pointing to another element, or (for images/icons) an `alt` attribute. When none of these are present, the control is essentially nameless — a screen reader announces only "checkbox" or "switch" with no clue what it toggles.
Without accessible names on toggles, blind and low-vision shoppers cannot use critical site controls: newsletter opt-ins, cookie consent switches, "Add to wishlist" toggles, product option selectors, and checkout preference checkboxes all become unusable. This directly blocks sales and exposes your store to legal risk under the ADA (USA), EN 301 549 (EU), and equivalent laws in many other markets — accessibility lawsuits against ecommerce stores have increased sharply year over year. Search engines also use accessibility signals as a quality indicator, so poorly accessible pages can indirectly affect your organic rankings. Fixing this typically takes under an hour and immediately removes a barrier for millions of users who rely on assistive technology.
See the complete Aria toggle field name guide for every platform and the full background.
Not sure if your WooCommerce store has this?
Run a free SEOLZ scan — we’ll find aria toggle field name and every other issue across your whole site.
Scan my site free