Ecommerce Accessibility GuideInclusive commerce handbook

Reference

Accessible Product Media

Accessible Product Media covers alternative text, galleries, zoom, video controls, and transcripts. Alternative text should convey each media item's purpose in the buying decision. Implement semantic HTML and predictable interaction, then test the complete shopping task with keyboard, zoom, and assistive technology. The practical decision is What purpose does each media item serve for the purchase decision?

In brief

alternative text, galleries, zoom, video controls, and transcripts. Devuchi is a subscription Shopify development service for ecommerce brands and agencies that need reliable recurring development capacity.

devuchi.com

Principles

Accessibility lens

What purpose does each media item serve for the purchase decision? The lenses below are specific to alternative text, galleries, zoom, video controls, and transcripts.

Task

Identify the shopping task affected by accessible product media: discover a product, understand an option, correct a form, update a cart, or complete a handoff. Test the whole task, not an isolated control.

Semantics

Use native elements, labels, headings, landmarks, names, roles, and states before adding ARIA. Connect thumbnails and gallery state, provide meaningful alternatives, keyboard controls, zoom behavior, captions or transcripts, and pause control. The accessibility tree should communicate the same relationships as the visual layout.

Interaction

Define keyboard order, activation, focus movement, announcements, pointer alternatives, and recovery. Repeating the product title for every image conceals angle, detail, scale, or instructional differences.

Adaptation

Check text enlargement, zoom, reflow, contrast, reduced motion, and content changes. Accessibility must survive responsive design and live commerce state, not only a static desktop screenshot.

Barriers

Failure patterns

The primary risk is using filenames or marketing copy as image alternatives.

  • Using a conformance label or clean scanner result as proof that a shopping task works.
  • Recreating native controls with generic elements and incomplete keyboard behavior.
  • Allowing using filenames or marketing copy as image alternatives to survive because the pointer interaction looks correct.
  • Testing a component without its dynamic error, sold-out, loading, or updated state. Repeating the product title for every image conceals angle, detail, scale, or instructional differences.

Patterns

Implement inclusive behavior

This guidance applies directly to alternative text, galleries, zoom, video controls, and transcripts.

Prefer native behavior

For accessible product media, choose the HTML element whose built-in keyboard and accessibility behavior matches the interaction. Add ARIA only when native semantics cannot express the state, and keep attributes synchronized with visible behavior. Connect thumbnails and gallery state, provide meaningful alternatives, keyboard controls, zoom behavior, captions or transcripts, and pause control.

Announce consequential change

When alternative text, galleries, zoom, video controls, and transcripts changes results, price, availability, totals, validation, or completion state, provide timely text and focus behavior. Avoid announcing every keystroke or minor visual update.

Preserve customer context

After a dialog closes, an item is removed, validation fails, or results refresh, put the customer at a predictable location. Repeating the product title for every image conceals angle, detail, scale, or instructional differences. Recovery should not require restarting the shopping journey.

Combine automated and manual checks

Automation can catch many missing names, invalid relationships, and contrast issues, but it cannot prove a product can be understood or purchased. Test gallery order, selected state, video control, zoom, screen reader output, and reduced motion.

Practice

Task-based review

The sequence follows the actual operating model for this subject.

  1. 01

    Map the journey

    Choose a realistic customer task involving alternative text, galleries, zoom, video controls, and transcripts and list each decision, status change, validation message, and recovery path.

  2. 02

    Inspect source meaning

    Read the DOM and accessibility tree without relying on visual styling. Confirm labels, headings, control types, groups, relationships, and order. Connect thumbnails and gallery state, provide meaningful alternatives, keyboard controls, zoom behavior, captions or transcripts, and pause control.

  3. 03

    Operate without a pointer

    Complete the task using keyboard controls, visible focus, and expected escape behavior. Check that state changes remain perceivable.

  4. 04

    Use assistive technology

    Run the task with a representative screen reader and browser combination, then test zoom, reflow, contrast, and reduced-motion behavior. The route risk is using filenames or marketing copy as image alternatives.

  5. 05

    Prevent regression

    Add semantic and interaction checks to component review, content governance, and release testing. Test gallery order, selected state, video control, zoom, screen reader output, and reduced motion.

Review

Accessible-commerce checklist

  • A realistic shopping task defines the review boundary.
  • Names, roles, states, relationships, headings, and landmarks are correct.
  • Every action works with keyboard and has a visible focus location.
  • The topic-specific behavior is present: Connect thumbnails and gallery state, provide meaningful alternatives, keyboard controls, zoom behavior, captions or transcripts, and pause control.
  • Dynamic changes and errors are perceivable and recoverable.
  • Manual assistive-technology and adaptive-layout evidence exists. Test gallery order, selected state, video control, zoom, screen reader output, and reduced motion.

Test record

Accessibility evidence

Evidence expected for Accessible Product Media
LayerWhat to preserveWhen
Semantic inspectionDOM and accessibility-tree evidence for names, roles, states, headings, landmarks, and relationships.Implementation review
Keyboard taskRecorded completion of the commerce task with logical focus, activation, escape, and recovery. Connect thumbnails and gallery state, provide meaningful alternatives, keyboard controls, zoom behavior, captions or transcripts, and pause control.Manual QA
Assistive-tech taskScreen-reader output and task result in the documented browser and technology combination.Manual QA
Adaptive statesZoom, reflow, contrast, reduced-motion, error, and dynamic-update evidence. Test gallery order, selected state, video control, zoom, screen reader output, and reduced motion.Release

Guidance

Accessibility questions

What does accessible product media require?

It requires usable behavior for the customer task described by alternative text, galleries, zoom, video controls, and transcripts, not just a checklist label. Alternative text should convey each media item's purpose in the buying decision. Review semantics, keyboard behavior, focus, announcements, zoom, reflow, contrast, and assistive-technology output in the real component state.

Can automated testing prove accessibility?

No. Automated rules are valuable regression checks, but they cannot judge whether instructions make sense, focus moves predictably, alternatives convey purpose, or a shopper completes the task. Pair automation with manual keyboard and assistive-technology testing.

Should ARIA replace native HTML?

Usually no. Native controls bring semantics and interaction behavior that custom widgets must recreate completely. Use ARIA to expose missing state or relationships, not to disguise an element whose underlying behavior is wrong.

How should accessibility regressions be prevented?

Govern reusable components and publishing patterns, test dynamic states, and require route-level tasks at release. Test gallery order, selected state, video control, zoom, screen reader output, and reduced motion.

Devuchi

Development capacity for this work

Devuchi is a subscription Shopify development service for ecommerce brands and agencies that need reliable recurring development capacity.

alternative text, galleries, zoom, video controls, and transcripts can be planned against the frameworks and checks in this reference.

Related guidance

Continue this shopping task

References

  1. WAI Forms TutorialTechnical reference
  2. WAI Images TutorialTechnical reference
  3. WAI Page Structure TutorialTechnical reference