How to fix aria input field name on Shopify

Add a meaningful accessible name (label) to every ARIA input field so screen readers can identify and announce it to users.

Steps for Shopify

  1. Go to Online Store → Themes → click the three-dot menu next to your active theme → Edit code.
  2. Search for the ARIA role causing the issue (e.g., role="textbox") using the search bar in the code editor across Sections, Snippets, and Layout files.
  3. Open the relevant file (e.g., sections/header.liquid for a search bar, sections/main-cart-footer.liquid for cart inputs) and add a <label> or aria-label to the affected element.
  4. For Shopify's built-in search input, locate the search form snippet (often snippets/predictive-search.liquid or the Dawn theme's search-modal.liquid) and ensure the <input> element has aria-label="Search" or a linked <label>.
  5. Save the file and use the Shopify theme preview plus a browser axe extension to confirm the fix.
  6. If you use a third-party theme or app that injects forms (e.g., reviews, currency selectors), contact the app developer or use the 'Edit code' approach to override their template snippets.
Official Shopify documentation ↗
<label for="product-search">Search products</label>
<input id="product-search" type="text" role="searchbox" />

<!-- OR, when a visible label isn't possible: -->
<input type="text" role="searchbox" aria-label="Search products" />

<!-- OR, referencing existing visible text: -->
<h2 id="filter-heading">Filter by price</h2>
<input type="text" role="spinbutton" aria-labelledby="filter-heading" />

What is aria input field name?

Any interactive form field that uses an ARIA role (such as `role="textbox"`, `role="spinbutton"`, `role="searchbox"`, `role="combobox"`, or `role="slider"`) must have an accessible name — a short text label that describes what the field is for. This name can be provided via an HTML `<label>` element, an `aria-label` attribute, or an `aria-labelledby` attribute pointing to visible text on the page. Without it, assistive technologies like screen readers have nothing to announce when a user reaches the field. WCAG Success Criterion 4.1.2 (Name, Role, Value) requires that all user interface components have a name that can be determined programmatically.

Screen reader users — including many people with visual impairments — rely entirely on accessible names to understand what a form field is asking for. An unnamed input field is announced as a blank or generic "edit field," leaving the user completely unable to fill it in correctly, which means lost sales, failed sign-ups, and broken checkout flows on your store. Beyond conversions, failing WCAG 4.1.2 is one of the most commonly cited violations in accessibility lawsuits and regulatory audits (ADA, Section 508, EN 301 549, and the EU Web Accessibility Directive), exposing your business to real legal and financial risk. Fixing it also improves SEO indirectly, since search engines use semantic HTML signals — including proper labeling — to better understand page content and forms.

See the complete Aria input field name guide for every platform and the full background.

Not sure if your Shopify store has this?

Run a free SEOLZ audit — we’ll find aria input field name and every other issue across your whole site.

Scan my site free

Fix aria input field name on another platform