Making commerce better for everyone means caring deeply about making quality products. A quality product should have a fantastic user experience (UX), including:

  • A beautiful and functional design
  • Consistent and useful copy
  • Principles of universal design and inclusivity

Usable for everyone

It’s important that Shopify products—and Partner products—are usable and useful to everyone.

Everyone is a pretty big group. It includes our merchants, their customers, our developer partners, our employees, and the greater tech community at large. That also includes all members of our community who have disabilities.

Disabilities may affect how people move, see, hear, communicate, learn, understand, and process information. As a result, it’s important to consider how to design and develop your product to support a wide range of needs and experiences.

In the United States, as many as 1 in 4 adults has at least 1 disability [Source: CDC]. In Canada, the estimate is 22%, and elsewhere in the world the estimate is closer to 1 in 7 [Source: Statistics Canada, World Bank].

Building inclusive experiences

Using our components is a way to improve accessibility and consistency when building products for Shopify.

  • The component library in this style guide includes code we can use across applications
  • This component code includes accessible markup
  • Since the code exists in a single component that gets reused, it’s easier to update and fix any bugs

The build-it-once, use-it-everywhere model means the accessibility knowledge of the designers and developers who build these components is now available to all of Shopify and our partners. This way our users get a consistent experience that can be leveraged into accessible products.

Many accessibility features come free in the components. But, it’s important to make sure that components are integrated in a way that doesn't create unforeseen accessibility barriers. Depending how components are used, there may be more design and implementation considerations. Be sure to test user task flows post integration.

Assistive technology support

Our components are tested for accessibility with automated and manual techniques. Merchants should expect to be able to access features built with our components using modern assistive technologies. These include native and third-party tools like:

  • Screen readers
  • Speech recognition programs
  • Supports for low vision and color blindness
  • Alternative keyboards
  • Switch devices
  • Tools for readability

Coding standards

Polaris components start with web standards for HTML, CSS, and JavaScript. Features from the Accessible Rich Internet Applications (WAI-ARIA or ARIA) specification are used to build functionality that is not available in native HTML.

Alternative text

To help people who rely on assistive technologies, such as a screen reader or other text to speech programs, our components use alternative text for icons and images used to convey information and actions (like buttons and links).

Meeting the Web Content Accessibility Guidelines (WCAG)

Polaris targets WCAG 2.1 Level A and Level AA success criteria, and seeks to provide a highly usable experience for everyone.

For more information, see the following resources:


Sometimes, building accessible and inclusive experiences can be difficult. If we’ve made any mistakes in this style guide, please reach out by creating a GitHub issue and help us make it better.