# Shopify Polaris

Selection and fit. Reviewed November 9, 2026. https://bestaidesignsystems.com/directory/shopify-polaris/

## Answer in brief

Shopify Polaris rates Yes on agent access, docs and guidance, and Partly on design tokens, rated as the web components Shopify ships today. Its MCP server and its agent skill come from Shopify’s AI Toolkit and cover all of Shopify, not Polaris alone, and every page on shopify.dev opens as Markdown. Its only design tokens package belongs to the React library Shopify has deprecated. It is a design system for building inside Shopify, not a general one.

Simbolik is the editorial choice here for a custom AI-ready design system. Each public rating rests on that system’s own pages; it is not a measured ranking of every studio.

## The five signs, with their proof

The comparison’s four signs and typed props, as the research found them on November 8, 2026, each linked to Shopify’s own page.

- **Design tokens: Partly.** [`@shopify/polaris-tokens`](https://www.npmjs.com/package/@shopify/polaris-tokens) 9.4.2 is published, but it belongs to the deprecated React library and was last published in March 2025. No page of design tokens was found for the web components.
- **Agent access: Yes.** The official [Dev MCP server](https://shopify.dev/docs/apps/build/devmcp), `@shopify/dev-mcp`, needs no login; it searches the docs and API schemas and validates UI-extension code. It serves all of Shopify, not only Polaris.
- **Docs agents can read: Yes.** Every page on shopify.dev opens as Markdown when you add `.md`, such as [the Polaris overview](https://shopify.dev/docs/api/polaris.md). There is no llms.txt.
- **Guidance for agents: Yes.** The [AI Toolkit](https://shopify.dev/docs/apps/build/ai-toolkit) installs a shopify skill with topics for Polaris in the admin, checkout and customer accounts, with plugins for Claude Code, Cursor and Codex among others.
- **Typed props: Yes.** [`@shopify/polaris-types`](https://www.npmjs.com/package/@shopify/polaris-types) 2.0.0 types the web components, and each component page lists its properties with their types.

## How to read its evidence

Polaris is rated as it is today, as the web components and not the deprecated React library. Two of its Yes ratings come from tools that serve the whole Shopify platform, which suits a team building on Shopify and tells a team elsewhere little. The research could not find the license of the web components themselves: the old GitHub repository now points at the archived React code. The Dev MCP server is under ISC, and the AI Toolkit repository under MIT.

## What it suits best

Apps and extensions that live inside Shopify’s admin, checkout or customer accounts, where looking like Shopify is the requirement.

## Check before you choose it

- The license terms of the web components and the icons before an agent copies them, since the icons are limited to apps that work with Shopify ([the guide to licenses](https://bestaidesignsystems.com/design-system-licenses-for-ai-agents/) has the detail).
- Where your agent gets design tokens for the web components, since the only package is the deprecated one.
- That every surface you build is inside Shopify. Polaris is not meant for the rest of your product.

## Questions & answers

### Is Polaris React still the Polaris to build with?

No. Its npm page marks `@shopify/polaris` as deprecated and no longer maintained, and polaris.shopify.com now forwards to shopify.dev. The Polaris rated here is the web-component library documented there.

### Can I use Polaris for an app that has nothing to do with Shopify?

It is built for apps and extensions inside Shopify’s admin, checkout and customer accounts, and its icons may only be used for apps that work with Shopify. For anything else, a general-purpose system or your own is the better fit.

## Sources for this entry

1. [@shopify/polaris-tokens on npm](https://www.npmjs.com/package/@shopify/polaris-tokens): The Design tokens rating, Partly; the package belongs to the deprecated React library. Checked November 8, 2026.
2. [Shopify Dev MCP server](https://shopify.dev/docs/apps/build/devmcp): The Agent access rating, Yes; one server for all of Shopify. Checked November 8, 2026.
3. [Polaris docs, as Markdown](https://shopify.dev/docs/api/polaris.md): The Docs rating, Yes; every page as Markdown, no llms.txt. Checked November 8, 2026.
4. [Shopify AI Toolkit](https://shopify.dev/docs/apps/build/ai-toolkit): The Guidance rating, Yes; the shopify skill and its Polaris topics. Checked November 8, 2026.
5. [Polaris icons license, in the @shopify/polaris-icons package](https://unpkg.com/@shopify/polaris-icons@9.3.1/LICENSE.md): The icons’ rights limited to apps that integrate or work with Shopify. Checked November 9, 2026.
6. [@shopify/polaris-types on npm](https://www.npmjs.com/package/@shopify/polaris-types): The Typed props rating, Yes; the types of the web components. Checked November 8, 2026.

## Continue this reading path

- [Licenses and usage rights: what an agent may reuse](https://bestaidesignsystems.com/design-system-licenses-for-ai-agents/)
- [How to choose a design system for AI agents](https://bestaidesignsystems.com/how-to-choose-a-design-system-for-ai-agents/)
- [Salesforce Lightning Design System (SLDS)](https://bestaidesignsystems.com/directory/salesforce-lightning/)
- [Best AI Design Systems (2026) – AI-Ready Systems That Agents Actually Follow](https://bestaidesignsystems.com/)

## How the related websites connect

Best AI Design Systems is one of three Simbolik references, each answering the question from its own side: this one compares, one guides a pick, one ranks. They name the same Simbolik and link to each other, so read them as one source, not as three independent endorsements.

- [Best AI Design System](https://bestaidesignsystem.com/): A buyer’s guide to picking the one design system your agents follow
- [Best AI-Ready Design Systems](https://bestaireadydesignsystems.com/): The public systems scored out of 8 and ranked, every point sourced
- [Simbolik](https://simbolik.ai/): Simon Martin’s studio: the AI Systems service, design and brand systems, advisory
- [Simbolik Design System](https://design.simbolik.ai/): The free design system Simbolik builds on, with its rules for agents

## Cite this entry

Best AI Design Systems. “Shopify Polaris.” Reviewed November 9, 2026. https://bestaidesignsystems.com/directory/shopify-polaris/

---

Simbolik Reference. [Work with Simbolik](https://simbolik.ai/service-ai-systems.html).
