How to fix aria allowed attr on BigCommerce

Steps for BigCommerce

1. Go to Storefront → My Themes → click 'Edit Theme Files' for your active theme to open the Stencil file editor.
2. Search template files (templates/components/, templates/layout/, and assets/js/) for the flagged aria-* attribute using the editor's search function.
3. Correct the attribute in the relevant Handlebars (.html) or JavaScript file.
4. If the violation originates from a widget added via Page Builder (Marketing → Page Builder), click the widget in the visual editor and look for an ARIA/accessibility field to correct, or remove the widget and recreate it without the bad attribute.
5. Publish the theme and re-run your accessibility audit to confirm the fix.

What is aria allowed attr?

ARIA (Accessible Rich Internet Applications) is a set of special HTML attributes — like `aria-checked`, `aria-expanded`, `aria-required` — that tell screen readers and other assistive technologies what a page element is and how it behaves. Each HTML element has a "role" (either its native role, such as `button` or `checkbox`, or one you assign with `role="…"`), and only certain ARIA attributes are valid for each role. The `aria-allowed-attr` rule flags situations where an ARIA attribute is applied to an element whose role does not support it — for example, putting `aria-checked` on a plain `<div>` with no appropriate role, or adding `aria-expanded` to an element whose role never has an expandable state. These mismatches are recognised by automated accessibility scanners and flagged against WCAG 4.1.2 (Name, Role, Value).

Screen readers like JAWS, NVDA, and VoiceOver rely on ARIA attributes to announce the correct state and purpose of interactive controls to blind and low-vision shoppers. When an ARIA attribute is mismatched to its element's role, the screen reader either ignores it silently or announces confusing, incorrect information — causing those customers to misunderstand your navigation, forms, filters, and checkout controls. This directly reduces conversions among users with disabilities and exposes your store to legal risk under accessibility laws (ADA Title III in the US, EN 301 549 in the EU, and equivalent legislation elsewhere) that increasingly require WCAG 2.1 AA compliance. Search engines also use ARIA signals to better understand page structure, so clean, valid markup supports long-term SEO health as well.

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