Shopify Craft theme — accessibility hot-spot audit
Accessibility hot-spots in Craft
Color contrast on Craft
Auto-fixWCAG: 1.4.3 Contrast (Minimum)
Craft default palettes ship with body-text colors that frequently fall below the 4.5:1 luminance threshold once a merchant adjusts background tints or section backgrounds. The contrast failure compounds on muted seasonal palettes.
Product image alt text passthrough
Auto-fixWCAG: 1.1.1 Non-text Content
The theme renders alt text from the Shopify Admin product-image setting. Merchants who upload images without setting alt text get an empty `<img alt="">`, which screen readers skip silently. Auto-fix populates alt text from product titles + AI-generated descriptions.
Long-form story section heading structure
Flag for reviewWCAG: 2.4.10 Section Headings
Editorial story sections often render as a single block of text without h2 subheadings. Auto-fix flags long prose blocks for the merchant to add structure.
Icon-only buttons (cart, search, account)
Auto-fixWCAG: 4.1.2 Name, Role, Value
Header icons (cart, search, account) often render as `<a><svg/></a>` with no `aria-label`, leaving screen readers to announce only "link" with no description. Auto-fix adds `aria-label` per icon and `aria-hidden="true"` on the inner SVG.
Cart drawer focus management
Auto-fixWCAG: 2.1.2 No Keyboard Trap
Cart-drawer modals open as overlays without enforcing a focus trap — keyboard users tabbing through the page after opening the drawer can land on background elements. Auto-fix patches the drawer JavaScript to trap focus, handle Escape, and restore focus to the trigger on close.
FAQ
Is the Shopify Craft theme accessible by default?
Shopify has not published a Theme VPAT for Craft. The theme is engineered with accessibility in mind, but accessibility regressions appear in standard merchant customizations (color palette, section layouts, third-party apps). The hot-spots above are the most common predictable regressions based on the theme's structural patterns.
What WCAG criteria does Craft most often fail?
Across stores running Craft, the most-frequently-cited criteria are 1.1.1 Non-text Content (alt text), 1.4.3 Contrast Minimum (color contrast), 4.1.2 Name, Role, Value (icon-only buttons), and 2.5.8 Target Size Minimum (mobile tap targets). Each maps to a deterministic theme-code fix.
Can AccessComply fix Craft accessibility issues automatically?
Yes. AccessComply scans the live Craft storefront, identifies WCAG 2.1 + 2.2 AA failures, and writes source-code fixes directly to the theme files via the Shopify Admin API. Roughly 70-80% of common violations auto-fix; the remainder are flagged for manual review with suggested code changes.
Will AccessComply break my Craft customizations?
No. Every fix is preceded by a full theme backup. Fixes are scoped to specific WCAG-relevant attributes and styles — not the merchant's custom layout, copy, or branding. If a fix introduces a regression, the post-fix re-scan triggers automatic rollback.
Run a real Craft scan
AccessComply scans your live Craft storefront for the hot-spots above and writes source-code fixes directly to your theme files.