Home / Resources / WCAG 2.1 Guide

WCAG 2.1 AA: The Complete E-Commerce Guide

WCAG 2.1 Level AA is the accessibility standard courts use to evaluate ADA compliance for websites. This guide explains every principle that matters for Shopify and e-commerce stores — in plain language, with real examples.

What Is WCAG 2.1 AA?

The Web Content Accessibility Guidelines (WCAG) 2.1 are published by the W3C and define how websites should be built to be accessible to people with disabilities. "Level AA" is the middle conformance level — it's what the DOJ adopted as the legal standard for ADA compliance.

WCAG 2.1 AA consists of 50 success criteria organized under four principles: Perceivable, Operable, Understandable, and Robust (POUR). Failing any single criterion can constitute an ADA violation and grounds for a lawsuit.

Principle 1: Perceivable

Information and UI components must be presentable to users in ways they can perceive. Users who are blind, low-vision, deaf, or hard of hearing depend on these requirements.

CriterionWhat It MeansE-Commerce ImpactSeverity
1.1.1 Alt TextAll non-text content has a text alternativeEvery product image, banner, icon needs alt text. The #1 violation on Shopify stores.Critical
1.3.1 Info & RelationshipsStructure conveyed visually also available programmaticallyForm labels, table headers, list markup, heading hierarchyCritical
1.4.3 Contrast (Minimum)Text has 4.5:1 contrast ratio (3:1 for large text)Sale badges, muted text, ghost buttons, placeholder textHigh
1.4.4 Resize TextText can be resized to 200% without loss of contentFixed-size containers that clip text at larger sizesMedium
1.4.11 Non-text ContrastUI components have 3:1 contrast against adjacent colorsInput borders, checkbox outlines, button bordersHigh

Principle 2: Operable

UI components and navigation must be operable by all users — including those who cannot use a mouse and rely entirely on keyboard navigation.

CriterionWhat It MeansE-Commerce ImpactSeverity
2.1.1 KeyboardAll functionality operable via keyboardDropdowns, color swatches, modals, sliders — all must work without a mouseCritical
2.1.2 No Keyboard TrapFocus can be moved away from any componentModal dialogs, video players, date pickers that trap keyboard usersCritical
2.4.3 Focus OrderFocus order preserves meaning and operabilityTab order must match visual layout — broken in many themesHigh
2.4.4 Link PurposeLink purpose determinable from link text alone"Click here," "Learn more," "Read more" are all violations without contextHigh
2.4.7 Focus VisibleKeyboard focus indicator visibleMany Shopify themes set outline:none globally — this is a violationCritical

Principle 3: Understandable

Information and the operation of the UI must be understandable. This covers predictable behavior, clear instructions, and helpful error handling.

CriterionWhat It MeansE-Commerce ImpactSeverity
3.3.1 Error IdentificationInput errors identified and described in textCheckout validation errors must be programmatically associated with their fieldsCritical
3.3.2 Labels or InstructionsLabels provided for user inputEvery form field — quantity, address, card, coupon — needs a proper labelCritical
3.2.3 Consistent NavigationNavigation repeated in same relative order across pagesInconsistent header/footer across templatesMedium

Principle 4: Robust

Content must be robust enough to be reliably interpreted by assistive technologies. This is primarily about clean HTML and proper ARIA implementation.

ℹ️ ARIA is a double-edged sword

Incorrect ARIA implementation can be worse than no ARIA at all. Adding aria-label to every element or misusing roles creates a worse experience for screen reader users. ARIA should be applied by specialists who test with real AT.

Special Considerations for Shopify

The Checkout Problem

Shopify's checkout is hosted on Shopify's own servers — which means third-party overlay tools cannot touch it. Until Checkout Extensibility (available on Shopify Plus and newer plans), the checkout was largely a black box for accessibility developers. Today, it can be remediated — but only through Shopify's official extensibility framework, which requires specialized knowledge.

Theme Architecture

Most Shopify themes are built using Liquid templating with heavy JavaScript for dynamic interactions. Accessibility fixes must be implemented in Liquid templates, JavaScript event handlers, and CSS — not just HTML. This is why generalist developers often miss Shopify-specific violations.

Dawn Theme Issues

Shopify's default Dawn theme ships with several accessibility issues out of the box — including keyboard navigation problems in the cart drawer and color contrast failures in certain configurations. Every Dawn-based store needs accessibility review regardless of customization.