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 shop with the new Shopify admin design.
Adopting Polaris 2.0 is explicit. Apps using polaris-1.js or the legacy 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 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.