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.
Apps that follow the App Design Guidelines, and meet other applicable criteria, are eligible for Built for Shopify status.
Summer Editions 2023 ChangelogWe've introduced the following changes to improve and update the App Design Guidelines:
- We've reframed
Cautiondirectives, to improve clarity. Former
Cautiondirectives are now labeled as either
Do Not, changed to a
Tip, or removed entirely.
Do Not, to make it clear that all of these directives are mandatory if you're submitting your app to the Built for Shopify program.
- We've added and updated directives. This content is identified by new updated badges.
- We've added new sections for Forms, Marketing, and Admin UI extensions.
Why you should use these guidelinesAnchor link to section titled "Why you should use these guidelines"
Built for ShopifyApps must meet all directives to qualify for the Built for Shopify program. Achieving Built for Shopify status gives your app preferential treatment in the Shopify App Store and signals to merchants that you meet our standards for quality and trust.
A better merchant experienceMerchants expect a predictable user experience that works like the rest of the Shopify admin. Put merchant needs and context ahead of trying to make your app unique just for the sake of being different.
AdaptiveWith the majority of online store traffic happening on mobile, designing for mobile devices must be at the forefront of the app building process.
AccessibleTo provide a great experience for all Shopify merchants and their customers, apps must be built using accessibility best practices.
Directives updatedAnchor link to section titled "Directives"
There are distinct directives that you must follow to meet the App Design Guideline standards. Some directives also determine if your app will be approved for the Shopify App Store. These directives are identified with App Store Requirement.
Must DoYour app must meet these requirements to pass the App Design Guidelines portion of the Built for Shopify review.
Do NotIf your app contains these behaviors, patterns, or content, then it won’t pass the App Design Guidelines portion of the of Built for Shopify review.
Apps and the Shopify adminAnchor link to section titled "Apps 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.
Using Shopify App Bridge, you can create apps directly inside the Shopify admin. A single frontend that's written with Shopify App Bridge can power point-of-sale, desktop, and mobile experiences. Apps built with Shopify App Bridge are more performant, flexible, and have more features.
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.
Start building now
Learn about some of the patterns, components, and features that are common in Shopify apps by building an example app.
Polaris newAnchor link to section titled "Use Polaris"
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, tokens, and best practices of Polaris, which is the Shopify admin design system.
We are constantly innovating and evolving the admin. By using Polaris, your app can evolve with us.
RecommendedYour app’s UI should show a good faith effort to follow the user experience norms of the Shopify admin, which supports merchant trust and usability. The easiest way to do this is by using the Polaris design system.
Polaris v12 beta
App Design Guideline examples use the visual design of the Polaris v12 beta. Functionality is unstable and we expect breaking changes that will require developers using the v12 beta to update their apps in alignment. Learn more.