How to fix aria input field name on Shopify Plus

Add a descriptive accessible name (aria-label, aria-labelledby, or a visible <label>) to every ARIA input field so assistive technologies can identify it.

Steps for Shopify Plus

  1. Same steps as Shopify above. Additionally, if you use Checkout Extensibility (the new checkout editor), go to Settings → Checkout → Customize and inspect any custom checkout UI extensions you have installed.
  2. For custom checkout UI extensions built with Shopify's checkout UI kit, ensure every <TextField> component includes the required label prop — Shopify's own components handle aria-label automatically when label is supplied.
  3. For legacy checkout.liquid (if still enabled on your Plus plan), edit the file directly at Online Store → Themes → Edit code → layout/checkout.liquid and apply the same aria-label or <label for> patterns.
Official Shopify Plus documentation ↗

What is aria input field name?

An "ARIA input field name" is the text label that screen readers and other assistive technologies announce when a user focuses on a form field — a text box, search bar, date picker, quantity field, or any other input that uses an ARIA role like `textbox`, `spinbutton`, `searchbox`, `slider`, or `combobox`. When that label is missing or empty, the field has no accessible name. WCAG Success Criterion 4.1.2 (Name, Role, Value) requires every user-interface component to have a name that programs can determine. A field without a label is essentially invisible to assistive technology users.

Screen reader users — including many customers with visual impairments — cannot understand what to type into an unlabeled field, which means they cannot complete your checkout, search for products, or fill in any other form on your site. This directly costs you sales and excludes a significant portion of your potential customers. Legally, WCAG 2.1 AA compliance (which includes SC 4.1.2) is referenced in accessibility laws and regulations in the US (ADA), EU (EAA), UK (PSBAR), and elsewhere — stores with unlabeled form fields are at real legal risk. Search engines also use accessible markup signals as part of overall quality assessment, so fixing this contributes to long-term SEO health.

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 scan — 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