Skip to main content

App Design Guidelines

Shopify's App Design Guidelines show you what great Shopify apps look like and how they're crafted. These guidelines remove the guesswork, so you can build apps that are predictable and easy to use.

Anchor to Apps and the Shopify adminApps and the Shopify admin

Apps are a crucial part of the Shopify ecosystem. They enable merchants to add functionality to their stores without leaving the familiar environment of the Shopify admin.

Your app's main experience in the admin is called App Home. Using Shopify App Bridge, you can create apps directly inside the Shopify admin. App Bridge is a JavaScript SDK, and its web components place elements such as the title bar and nav menu in the admin chrome around your app. A single frontend renders on desktop and in the Shopify mobile app.

By building with Shopify App Bridge and following these App Design Guidelines, you'll create a streamlined experience with the rest of the Shopify admin.

An s-app-nav web component with nested s-link elements, shown beside the app navigation it renders in the Shopify admin.

We believe that the best apps provide merchants with a user experience that matches the appearance and behaviors of the Shopify host surface. This consistency builds merchant trust, because merchant workflows often cross between apps and native pages of the Shopify admin.

For apps embedded into the Shopify admin, we recommend using the components and best practices of Polaris, Shopify's unified system for building app interfaces. See Visual design for how to apply it to your app's color, typography, and icons.

We're constantly innovating and evolving the Shopify admin. By using Polaris, your app can evolve with us.

An annotated App Home page with callouts for consistent spacing, header hierarchy, and a high contrast background.

Your app's UI should demonstrate a good faith effort to leverage common UX best practices and meet a high bar for design quality.


Anchor to Why you should use these guidelinesWhy you should use these guidelines

We base our design guidelines on some basic principles, which we communicate through clear directives. Following these directives helps provide a better app experience for merchants.


Was this page helpful?