Accessibility for themes

When you customize your theme, it’s a good idea to make design and content choices that help to keep your online store accessible. An accessible website is designed so that it can be used by everyone, including people with disabilities. Accessibility for your online store is essential to providing an inclusive experience for your customers.

The guidelines below were created with the Web Content Accessibility Guidelines (WCAG) in mind. Since there are many factors to consider when creating an accessible website, following these guidelines alone doesn't guarantee that your online store is fully accessible. You can learn more about web accessibility by visiting the WCAG website, or by seeing the resources listed below.

Text accessibility

It's important that the text on your online store is readable for customers who are visually impaired or who have difficulty reading dense blocks of text.

Color contrast

When you edit the colors for your online store, make sure that all of your text is accessible to customers who are colorblind or otherwise visually impaired. These customers rely on adequate color contrast to visually differentiate one thing from another. You can use an online contrast ratio tool to check the contrast of the different parts of your store. Test the contrast of all text, including body text, headings, links, and form fields. Use the following guidelines:

  • The color of body text and button text has a contrast ratio of at least 4.5:1 against its background.
  • The color of headings and other large text (font size 24 px and up) has a contrast ratio of at least 3:1 against its background.
  • The color of all text over images, including slideshows, banners, and videos, has a contrast ratio of at least 4.5:1 against its background.

Text size and alignment

When you edit your theme's typography settings, make sure that your text is large enough and has consistent spacing. Use the following guidelines:

  • The minimum font size for body text is the equivalent of 16 px.
  • Text alignment is not justified. Justified text creates inconsistent spacing between words and letters, making the text harder to read.

When you add links to your text, make sure that they can be identified by all of your customers. Because some customers have trouble seeing color, you can't rely on a change in color alone to differentiate a link from regular text. Use the following guideline:

  • Text links are either underlined or have another visual differentiator from regular text.

Alternative text for images

When you add images to your online store, it's important to make them accessible to customers who are blind or have low vision. You can do this by adding alternative text that accurately describes each image. Customers who use screen readers rely on alt text to communicate the content of images on your online store.

You can add alt text to your product images from the Shopify admin. You can add alt text to the other images in your theme from the theme editor.

When you add alt text to an image, a good practice is to pretend that you're describing the image to someone who has their eyes closed. Help them to create an image in their mind. The way that you describe an image also depends on the context of your web page. For example, you might describe an image differently if your business is a travel agency than if your business is an outdoor equipment store. Consider the following image:

Two friends wearing backpacks with their arms around one another, looking out at the ocean

For a travel agency, you might refer to the country and region in which the two friends are traveling, and to the name of the ocean or sea that they're looking at. On the other hand, for an outdoor equipment store, you might focus on the brands and features of the two friends' backpacks.

If your business is a travel agency, then an example of poor alt text might be, "Two people in front of the ocean." For the same agency, an example of good alt text might be, "Two friends traveling in Lagos, Portugal, looking out at the sandy cove of Praia do Camilo on a sunny day."

To learn more about writing effective alt text, see Considerations when writing alt text on Medium.

Slideshow and video accessibility

When you add videos to your online store, make sure that you consider the needs of customers with low vision, hearing impairments, or vestibular disorders. Some of these customers rely on screen readers, which read aloud the contents of a web page. Additional audio, especially when it's unexpected, can make this experience difficult. For customers who are hearing impaired, it's a good idea to add closed captioning to your videos so that those customers can access the content. Customers with vestibular disorders can experience dizziness with moving content. Because of this, it's important that slideshows and videos don't play automatically.


When you add a slideshow to your online store, use the following guidelines:

  • Slideshows do not play automatically.
  • If slideshows do play automatically, then they include a setting that customers can use to pause or stop the slideshow.


When you add a video to your online store, use the following guidelines:

  • Videos do not play automatically.
  • If videos do play automatically, then their audio is muted.
  • For videos that include audio, the video is fully visible and not obstructed by other page elements. This allows closed captions to remain visible.
  • For videos that include dialogue, text transcripts are available.

These guidelines also apply to videos that are in a slideshow.

Keyboard support

When you edit your theme code, it's important that your changes don't prevent customers from being able to navigate your site with a keyboard. Customers with vision or motor impairment might use a keyboard to navigate and complete tasks online. These customers rely on a visual indicator to communicate where their keyboard’s focus is on a web page. In the example below, the Email field has a visual focus indicator:

A customer login screen on an online store that shows form fields for Email and Password. The Email field is outlined in blue.

If you edit your theme's stylesheet, then make sure that you don't remove the keyboard focus style from any page elements. Use the following guideline:

  • All interactive page elements have a clear visual indicator when they have keyboard focus. These elements include links, buttons, and form fields.


To learn more about web accessibility for the topics discussed in this article, see the following resources.

Color contrast resources

Text resources

Alternative text resources

Slideshow and video resources

Keyboard support resources

Ready to start selling with Shopify?

Try it free