Shopify Narrative theme — accessibility hot-spot audit
Accessibility hot-spots in Narrative
Hero overlay text contrast
Auto-fixWCAG: 1.4.3 Contrast (Minimum)
Text overlay on photography needs at least 4.5:1 contrast against the lightest pixels under the text. Auto-fix adds darkening overlay.
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.
Editorial heading hierarchy
Flag for reviewWCAG: 1.3.1 Info and Relationships
Story sections styled by visual size rather than semantic level — frequent skipped levels (h2 → h4). Auto-fix flags.
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.
Focus-visible styling on theme buttons
Auto-fixWCAG: 2.4.7 Focus Visible
Custom button styling sometimes overrides browser default focus rings without replacing them. Auto-fix scopes a high-contrast focus ring to `:focus-visible` so it shows for keyboard users without leaving a lingering ring after mouse clicks.
FAQ
Is the Shopify Narrative theme accessible by default?
Shopify has not published a Theme VPAT for Narrative. 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 Narrative most often fail?
Across stores running Narrative, 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 Narrative accessibility issues automatically?
Yes. AccessComply scans the live Narrative 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 Narrative 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 Narrative scan
AccessComply scans your live Narrative storefront for the hot-spots above and writes source-code fixes directly to your theme files.