# Shopify Polaris 2.0 is stable, but embedded apps must opt in to match the redesigned admin Shopify's October 22 Polaris 2.0 release is stable, yet existing embedded apps remain on Polaris 1.1 until developers change their CDN URL and test both admin designs. Built for Shopify apps face a May 2027 visual-alignment deadline. Polaris Web Components 2.0 reaches stable CDN channels, with explicit opt-in, React Router and TypeScript integration changes, and migration checks for apps that still use Polaris React. - Status: Active - Published: 2026-10-26T08:37:25+13:00 - Updated: 2026-10-26T08:37:25+13:00 - Categories: Web Development, Marketing & Distribution, Developer Tools, Marketplaces & Platforms - Tags: developer migration, Polaris, Shopify, Shopify apps, Web Components - Canonical HTML: https://beyondthe.news/dossiers/shopify-polaris-2-stable-cdn-embedded-app-opt-in-admin-redesign ## What changed On October 22, 2026, Shopify made Polaris Web Components 2.0 available on stable CDN channels as the first major release under its semantic versioning scheme. The new components can match the redesigned Shopify admin as it rolls out to merchants, while retaining the older visual treatment where that admin is still in use. Crucially, existing polaris.js and polaris-1.js script tags continue serving 1.1 and never automatically move to 2.x. Apps must opt in by loading polaris-2.js for the latest 2.x or polaris-2.0.js to pin the initial release. Shopify's September developer guidance separately gives Built for Shopify embedded App Home interfaces until May 1, 2027 to match the new admin visual style. ## Why it matters App developers now have a production-stable migration target rather than a release candidate, but the redesigned merchant admin can expose a mismatch with unchanged embedded app interfaces. Small teams maintaining older custom apps must identify which Polaris generation they use, choose whether to migrate, and test both admin appearances without accidentally loading duplicate bundles. Shopify says existing apps will not break simply because they remain on 1.x; this is an opt-in UI migration, not an immediate forced cutover. Built for Shopify status introduces a distinct future design-alignment deadline. ## Stable CDN URLs preserve explicit major-version control Shopify serves the latest 2.x release from polaris-2.js and offers polaris-2.0.js for teams that want to pin 2.0 specifically. The original polaris.js and polaris-1.js continue to serve 1.1. That protects existing interfaces from an automatic major-version change but means teams must deliberately adopt 2.x. The release is about embedded App Home web components, not a universal automatic restyle for every Shopify app. ## React Router and TypeScript apps need coordinated configuration For apps built from Shopify's React Router template, Shopify requires polarisUrl in both AppProvider and shopifyApp server configuration, with matching values, and @shopify/shopify-app-react-router 2.1.0 or later. TypeScript projects should use @shopify/polaris-types 2.x. Developers should ensure only one Polaris bundle loads, inspect custom CSS and legacy Polaris React components, and test overlays, save bars, side panels and sticky controls. ## Two admin designs complicate migration testing Shopify's redesigned admin began a progressive merchant rollout on September 15. Polaris 2.x chooses the appearance appropriate to the store's current admin. Shopify recommends testing a development store with the new-admin feature preview alongside the previous design. Developer forum reports during the release-candidate period described save-bar stacking and chip styling problems; these are anecdotal migration signals, not evidence that all remain unresolved in stable 2.0. ## Deadlines differ by app programme and component type Shopify says Built for Shopify embedded App Home interfaces should match the redesigned admin by May 1, 2027. It has not announced an end-of-support date for the 1.x CDN line in the October 22 release. Admin UI and App Home UI extensions receive the admin's design automatically and do not need this CDN opt-in; embedded apps using the older Polaris React component library require a more substantial move to web components. ## Key details - Polaris Web Components 2.0 stable release: October 22, 2026. - polaris-2.js tracks latest 2.x; polaris-2.0.js pins the 2.0 release. - polaris.js and polaris-1.js remain on 1.1; no automatic 2.x migration. - React Router template requires matching polarisUrl settings and @shopify/shopify-app-react-router 2.1.0 or later. - TypeScript projects should use @shopify/polaris-types 2.x. - Built for Shopify embedded App Home design-alignment deadline: May 1, 2027. - Admin UI and App Home UI extensions update visual treatment automatically; embedded App Home interfaces differ. - Shopify has not set an October 2026 forced retirement date for Polaris 1.x. ## Builder takeaways - Audit which Polaris CDN script each embedded app loads before planning an upgrade. - Test both old and redesigned Shopify admin appearances, including save bars, side panels, long forms, errors and fixed-position elements. - If using the React Router template, update client and server Polaris URLs together and verify the package version. - For a heavily customised app or older Polaris React interface, budget for CSS and component migration rather than assuming a one-line CDN change. - Do not confuse the May 2027 Built for Shopify visual requirement with a general forced shutdown of Polaris 1.x. ## What to watch - Stable 2.x bug-fix releases and reports on save-bar or overlay compatibility. - Shopify's rollout progress for the redesigned merchant admin. - Any announced Polaris 1.x support or deprecation timeline. - Updated Built for Shopify visual-compliance guidance before May 1, 2027. ## Uncertainties - Shopify has not stated when, if ever, the legacy Polaris 1.x CDN will be retired. - Forum migration reports came from the release-candidate period and may have been fixed in the stable build. - App migration effort depends heavily on legacy React components and custom CSS. - The Built for Shopify visual deadline is programme-specific rather than a blanket deadline for all apps. ## Sources - [Polaris 2.0 is now stable](https://shopify.dev/changelog/posts/polaris-cdn-2-0-is-now-stable) — Shopify Developer Changelog · primary · 2026-10-22T00:00:00+13:00. Stable release, CDN version behaviour and React Router/TypeScript requirements. - [Update your app for Polaris 2](https://shopify.dev/docs/apps/build/app-home/polaris2) — Shopify Developer Documentation · primary · 2026-10-22T00:00:00+13:00. Official migration checklist and testing guidance. - [Polaris 2.0 release candidate developer thread](https://community.shopify.dev/t/polaris-2-0-release-candidate/37957) — Shopify Developer Community · primary_developer_discussion · 2026-09-24T00:00:00+12:00. Built for Shopify May 2027 deadline and community-reported migration edge cases, mostly during RC. - [Shopify Polaris 2.0 Is Out. Your Custom App Won't Move](https://devpartners.co.uk/blog/shopify-polaris-2-custom-apps) — Dev Partners · independent_developer_analysis · 2026-10-24T00:00:00+13:00. Independent implementation-oriented assessment; consultancy perspective, not a performance benchmark.