The Polaris 2.0 release candidate is now available for embedded App Home interfaces. It includes the Shopify admin’s new visual styles, allowing your app to adopt the new look.
The new Shopify admin design began rolling out progressively to merchants on September 15, 2026. You can adopt the release candidate now and test your app across both the previous and new Shopify admin designs.
What changes when you adopt Polaris 2.0
When your app uses polaris-2.0-rc.js inside the Shopify admin, its Polaris Web Components match the current visual design of that store:
-
In a store with the new Shopify admin design, components use the new color, typography, spacing, and icons.
-
In a store with the previous Shopify admin design, components keep the same visual style as polaris-1.js.
If you render the components outside the Shopify admin, they default to the new visual style. This lets you test the new appearance before you have access to a store with the new Shopify admin design.
Adopting Polaris 2.0 is explicit. Apps using polaris-1.js or polaris.js URL don’t move to Polaris 2.0 automatically.
What this means for Built for Shopify
If your app is part of Built for Shopify, you have until May 1, 2027 to update your embedded App Home interface to match the Shopify admin’s new visual style.
Using the Polaris 2.0 release candidate lets you prepare during the progressive rollout of the Shopify admin. The components match the visual design available to each store, so the same app can support merchants on either Shopify admin design.
How to test the release candidate
Load the release candidate from the Shopify CDN:
<script src="https://cdn.shopify.com/shopifycloud/polaris-2.0-rc.js"></script>
Then test your app in the following contexts:
- A store with the new Shopify admin design, if you have access to one.
- A store with the previous Shopify admin design.
- Outside the Shopify admin, where components default to the new visual style.
If your app has fixed or sticky content near the bottom of the viewport, use the environment API’s –shopify-safe-area-inset-bottom CSS variable so the floating Sidekick bar doesn’t cover your interface.
Migrate from Polaris React
If your embedded App Home interface uses Polaris React, follow the migration guide for moving to Polaris Web Components.
Start with the Page, Section, and Button components. These components have the largest visual effect when aligning your app with the new Shopify admin design.
If your app already uses Polaris Web Components, update the CDN URL to the release candidate and test your existing interface. If your app doesn’t use Polaris Web Components, migrate first so you can adopt Polaris 2.0.
Extensions update automatically
Admin UI extensions and App Home UI extensions automatically match the Shopify admin design available to each merchant. Their functionality doesn’t change, and you don’t need to update extension code to receive the new styles.
Share your feedback
Reply in this topic if you find:
- A visual regression between polaris-1.js and polaris-2.0-rc.js.
- A component that doesn’t match the surrounding Shopify admin design.
- A layout problem caused by the new spacing, page structure, or buttons
FAQ
Will adopting Polaris 2.0 force the new visual design for every merchant?
No. Inside the Shopify admin, the components match the Shopify admin design available to each store.
Will polaris-1.js or polaris.js automatically move to Polaris 2.0?
No. Moving to a new major version is always an explicit change to your script tag.
How can I test if I don’t have access to a store with the new Shopify admin design?
Render the components outside the Shopify admin. They default to the new visual style.
Do Admin UI extensions or App Home UI extensions need to adopt Polaris 2.0?
No. Extensions automatically receive the Shopify admin design available to each merchant and don’t load Polaris Web Components from the CDN.
When do Built for Shopify apps need to update?
Built for Shopify apps have until May 1, 2027 to update their embedded App Home interface to match the Shopify admin’s new visual style. You will still need to match either the previous or new Shopify admin’s visual style until that time.
Can I use the release candidate in production?
You can, but the release candidate can change before the stable release. Test your app thoroughly and be prepared to update its CDN URL when Polaris 2.0 becomes stable.
Will the polaris-react library be getting an update?
No, the polaris-react library will not be getting an update to match the Shopify admin’s new visual styles.
