---
title: Polaris 2.0 release candidate - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/polaris-2-0-release-candidate'
  md: 'https://shopify.dev/changelog/polaris-2-0-release-candidate.md'
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: Polaris
    handle: polaris
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-09-23T11:34:42-04:00'
  postedAt: '2026-09-24T12:30:00-04:00'
  updatedAt: '2026-09-24T12:24:07-04:00'
  effectiveAt: '2026-09-24T12:00:00-04:00'
---

September 24, 2026

# Polaris 2.0 release candidate

DateSeptember 24, 2026

FlagsNew

SurfacesPolaris

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:

```html
<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](https://shopify.dev/docs/api/app-home/latest/apis/authentication-and-data/environment-api) 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](https://shopify.dev/docs/apps/build/app-home/migrate-from-polaris-react).

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.

## Related docs

* [Migrate from Polaris React to Polaris Web Components](https://shopify.dev/docs/apps/build/app-home/migrate-from-polaris-react)
* [App Home documentation](https://shopify.dev/docs/api/app-home)
* [Environment API](https://shopify.dev/docs/api/app-home/latest/apis/authentication-and-data/environment-api)
* [Polaris CDN semantic versioning](https://shopify.dev/changelog/the-polaris-cdn-is-adopting-semantic-versioning)
* [Shopify admin overview](https://help.shopify.com/en/manual/shopify-admin/shopify-admin-overview)