How to fix aria required attr on Squarespace

Steps for Squarespace

1. In the Squarespace Editor, go to Pages → select the page with the issue → click Edit.
2. For standard blocks (text, image, etc.), switch the block type to the correct semantic element: use a 'Heading' text block rather than a 'Body' block styled to look like a heading — Squarespace will output the correct `<h2>` tag natively.
3. For Code Blocks or custom HTML injections (Settings → Advanced → Code Injection or a Code Block), locate the element with `role=` and add the missing required attribute directly in that HTML snippet.
4. For theme-level changes, go to Design → Custom CSS — note this controls style only; for markup changes use Code Injection or a Code Block.
5. Save and publish, then verify with axe DevTools.

<div role="heading" aria-level="2">Featured Products</div>

<!-- Better: use native HTML which never needs aria-level -->
<h2>Featured Products</h2>

<!-- Slider example: all three value attributes required -->
<div role="slider"
     aria-valuenow="50"
     aria-valuemin="0"
     aria-valuemax="100"
     aria-label="Price range">
</div>

What is aria required attr?

ARIA (Accessible Rich Internet Applications) roles tell screen readers and assistive technologies what a piece of content is — for example, a heading, a slider, or a tree item. Many ARIA roles come with required attributes that must be present for the role to make sense. For instance, any element with `role="heading"` must also have `aria-level` (a number from 1–6) so assistive technology knows whether it's a top-level heading or a sub-heading. When a required attribute is missing, the ARIA role is effectively broken — like labelling a shelf "Aisle 3" but leaving out the aisle number.

Screen reader users — who are often unable to use a mouse and rely entirely on assistive technology — receive garbled or meaningless announcements when required ARIA attributes are absent. This directly blocks those users from understanding your page structure, navigating your store, or completing a purchase. Under WCAG 2.1 Success Criterion 4.1.2 (Name, Role, Value), all user interface components must expose correct role information to assistive technology; failing this criterion creates legal accessibility risk in the US (ADA), UK (Equality Act), EU (EAA), and beyond. Search engines also parse page structure using semantic signals — broken heading hierarchies and malformed ARIA can weaken how Googlebot understands and ranks your content.

See the complete Aria required attr guide for every platform and the full background.