Skip to content
IndexDesign corpus
Component LibrariesDesign System DocsComponent LibraryReferenceProprietary / all rights reservedFreeWeb Components

Shopify Polaris

Shopify's admin design system, now shipped as framework-agnostic web components

Aboutpolaris.shopify.com

Polaris is the design system every Shopify app and admin surface is built from. As of the 2025 'Polaris unified' release it is a set of 59 custom elements (s-button, s-page, s-money-field, ...) loaded from Shopify's CDN, replacing the deprecated @shopify/polaris React package, which is now archived. It is for developers building Shopify App Home, Admin UI extensions, Checkout UI extensions, Customer accounts and POS surfaces — not a general-purpose library you would drop into an unrelated product.

Install
npm i @shopify/polaris-types@latest # runtime comes from <script src="https://cdn.shopify.com/shopifycloud/polaris.js">
For an agent

Reach for this ONLY inside the Shopify ecosystem — if the task is a Shopify app, embedded admin block or checkout extension, Polaris is mandatory, and anything else in this index (shadcn, MUI, daisyUI) will be rejected by Shopify's review. Critical gotcha: polaris.shopify.com now 301s to shopify.dev/docs/api/polaris, the React package @shopify/polaris is deprecated and its repo is archived, so any model trained on pre-2025 data will emit dead React imports — write s-* custom elements instead. Styling is closed: you cannot theme these with Tailwind, so pair it with plain layout primitives (s-box, s-stack, s-grid) rather than fighting it.

Why it is here. It is the single largest captive design system on the web — every Shopify app must use it — and the 2025 React-to-web-components pivot is the kind of breaking change an agent will get wrong from memory.

Install command, framework, licence and component list.
Components it ships59 total
Helps you build16
Notable for
  • 59 s-* web components, framework-agnostic
  • Polaris React deprecated and archived in 2025
  • polaris.shopify.com now redirects to shopify.dev
  • mandatory for Shopify app review
  • CDN script, not a bundled npm runtime
Provenance

Verified 2026-08-16. HTTP 301. https://polaris.shopify.com (301 -> shopify.dev), https://shopify.dev/docs/api/polaris, https://shopify.dev/docs/api/app-home/web-components, https://api.github.com/repositories/88897663 (Shopify/polaris-react-archive), https://registry.npmjs.org/@shopify/polaris

Related resourcesComponent Libraries