How to fix aria input field name on Shopify Plus

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

Steps for Shopify Plus

  1. Follow all standard Shopify steps above; Shopify Plus also allows editing checkout.liquid (under Online Store → Themes → Edit code → Layout/checkout.liquid) for checkout-specific input fields.
  2. For custom checkout fields in the Checkout editor (Shopify Plus only), go to Settings → Checkout → Customize and use the drag-and-drop UI — for custom code blocks, add aria-label attributes directly in the custom HTML/Liquid blocks.
  3. If using Hydrogen (headless), edit the React component responsible for the input field and add an aria-label prop or a <label> element in your component JSX.
Official Shopify Plus 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 Plus 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