How to fix aria toggle field name on Squarespace

Steps for Squarespace

1. In your Squarespace Pages panel, open the page containing the toggle and click the block to edit it.
2. For native Form blocks with checkboxes, click the checkbox field → Edit, and ensure the 'Label' field is filled in with descriptive text — this text becomes the accessible name.
3. For icon-only toggle buttons in navigation or custom sections, go to Website → Pages → select the page → click Edit, then use a Code Block to inject a small JavaScript snippet that adds aria-label attributes to the toggle elements (see code snippet below).
4. For site-wide toggles (e.g. in the header or footer), go to Website → Website Tools → Code Injection and add a JavaScript snippet in the Footer section that selects the toggle elements and adds aria-label values.
5. Preview the page, open browser DevTools → Accessibility tab, and verify each toggle has an accessible name.

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.