Skip to content
Index730 resources
Shopify Polaris

Shopify Polaris

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

Tier A · StrongDesign System DocsComponent LibraryReferencepolaris.shopify.com

(Visit polaris.shopify.com ↗)
Preview image from polaris.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.

Facts

License
Proprietary / all rights reserved, Trademark / trade dress restricted
Pricing
Free
Framework
Web Components, Vanilla JS, React
Styling
Not applicable
Distribution
npm package, Direct download / asset pack
Platform
Web
Content type
Code, Design tokens / theme files, Prose / writing
Agent readiness
Structured documentation, CLI installable
Accessibility
Accessible, Keyboard navigable
Maturity
Actively maintained
GitHub stars
6,176
Package
@shopify/polaris-types

Components it ships

59 total
ButtonLinkDropdown MenuButton GroupChipBadgeBannerSpinnerCheckboxCheckbox GroupRadio GroupSelectSwitchColor PickerDate InputDate PickerFile UploadText InputPassword InputSearch InputNumber InputCurrency InputTextareaBoxSeparatorGridListPage HeaderResponsive WrapperSectionStackTableModalPopoverAvatarIconImageHeadingTypographyTooltip

Helps you build

16
Admin PanelSettings Web AppSubmitting A FormShowing Input ErrorMulti Step FormSaving ChangesUploading MediaData ImportBulk ActionsFiltering ItemsSingle Item DetailEmpty StateCheckoutOrder StatusBilling Web AppAnalytics

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

Also in Component Libraries

6
polaris.shopify.comTier A