Shopify fix guide
Fix Duplicate IDs on Shopify
IDs must be unique in the DOM.
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: Duplicate IDs →
At a glance
Instructional
Confusing tab order
DOM order matches layout
Duplicate IDs and broken ARIA relationships confuse assistive tech when it resolves references.
Where this comes from on Shopify
Theme Liquid, JSON templates, and app embeds. Coordinate with the theme or app vendor when markup is not yours.
What this issue means
Fix
Rename duplicates; generate stable unique ids for lists rendered in loops.
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
Ensure ids are unique per document; generate stable unique ids in lists.
Fix templates so duplicated components do not reuse hard-coded ids.
Common mistakes on Shopify
- Editing checkout (limited) vs theme—know which surface you can change.
- Forgetting to test accelerated/mobile themes.
How to verify the fix
- Preview the theme or use a development theme URL the scanner can reach.
- Test cart and collection templates if that is where the issue appeared.
- Rerun the scan after theme deploy; keep before/after report URLs.
Related: 4.1.1 Parsing (historically); best practice for robustness.
Same issue on other platforms
Related issues
Guides
Next steps
- Run a scan on staging or production.
- Re-read the main issue page for context and WCAG notes.
- Shopify accessibility hub for more platform resources.
TestAccessibility · Shopify fix · localhost:3001