How to fix aria allowed role on Squarespace

Remove or replace any ARIA `role` attribute that is not permitted on the HTML element it is applied to — in particular, do not add `role="textbox"` (or other interactive roles) to elements that already have a native semantic role which conflicts with it.

Steps for Squarespace

  1. Go to Pages → (your page) → Edit, and click on the block containing the flagged element.
  2. Squarespace blocks do not expose raw HTML for most native widgets. If the element is in a Code Block (Insert Block → Code), click Edit on that block and fix the `role` attribute directly in the HTML source.
  3. If the invalid role is in a Squarespace-generated widget (e.g. its built-in form or navigation), you can attempt to override it via Website → Pages → (page) → Advanced → Page Header Code Injection using JavaScript to remove the attribute after page load, or file a report with Squarespace support.
  4. Save and re-audit with WAVE or axe DevTools.
Official Squarespace documentation ↗

What is aria allowed role?

ARIA roles tell screen readers and other assistive technologies what kind of thing an element is — a button, a text field, a navigation landmark, and so on. Every HTML element already has a built-in (native) role, and the ARIA specification only allows certain roles to be layered on top of certain elements. When you attach a role that is not permitted — for example, adding `role="textbox"` to a `<select>` dropdown, a `<div>` that contains a native `<input>`, or any other element where that role is forbidden — the browser and assistive technology receive a contradictory or invalid instruction. The `aria-allowed-role` rule flags exactly these mismatches.

Screen-reader users (who navigate entirely by announced roles) may hear the wrong element type, skip the control entirely, or be unable to interact with it at all — blocking them from completing purchases, filling out forms, or accessing account features. This directly reduces conversions and exposes your store to legal risk under accessibility laws (ADA Title III in the US, EN 301 549 in the EU, AODA in Canada) that reference WCAG 2.x as the standard. Google's crawler also processes accessibility signals, and persistent WCAG violations can undermine your site's credibility in quality assessments. Fixing invalid ARIA is usually a quick code change with zero visible impact on design.

See the complete Aria allowed role guide for every platform and the full background.

Not sure if your Squarespace store has this?

Run a free SEOLZ scan — we’ll find aria allowed role and every other issue across your whole site.

Scan my site free

Fix aria allowed role on another platform