Skip to main content

Shopify fix guide

Fix Missing form labels on Shopify

Placeholder text is not a substitute for labels.

This page ties the generic issue to how it usually shows up in Shopify markup and tooling, then walks you through a fix and verification loop.

Verify on a live URL

Scan, fix, deploy, then rescan the same address to compare reports.

Main issue guide: Missing form labels

At a glance

Instructional

Programmatic label association

Screen readers announce the label; placeholders alone are fragile.

Where this comes from on Shopify

Often section Liquid, app embeds, or cart drawer fields where merchants customized snippets without labels.

What this issue means

What this issue is

Every input needs an accessible name, usually via `<label for>` wrapping, or `aria-label` when design constraints require it.

Fixes

Prefer visible labels. If space is tight, use persistent labels or aria-labelledby pointing to visible text.

How to fix on Shopify

In Shopify, prioritize theme Liquid and section JSON: product cards, cart drawers, and app embeds. Some issues need a theme developer or app vendor; capture the public report link when you open a ticket.

How to fix

Associate every input with a visible label, aria-labelledby, or aria-label when design constraints require it.

Surface errors next to fields and link them with aria-describedby.

Common mistakes on Shopify

  • Hard-coding inputs in Liquid without accessible names.
  • App fields duplicating ids.
  • Editing checkout (limited) vs theme—know which surface you can change.
  • Forgetting to test accelerated/mobile themes.

How to verify the fix

  1. Preview the theme or use a development theme URL the scanner can reach.
  2. Test cart and collection templates if that is where the issue appeared.
  3. Rerun the scan after theme deploy; keep before/after report URLs.

Related: 3.3.2 Labels or Instructions.

Same issue on other platforms

Guides

Next steps

TestAccessibility · Shopify fix · localhost:3001