Welcome to Polaris icons 👋

Polaris icons are simple and informative icons that draw on the visual language of the Polaris design system. Use these icons in your projects or third-party apps to promote a consistent experience across the Shopify platform.

Browse and search Polaris icons: https://polaris-icons.shopify.com.

On this page

• Packages
• Implementing icons
• Designing icons
• Contributing
• Licenses

Packages

The Polaris icons repository contains a set of packages. The packages are all related to each other, so a change to one might necessitate a change to another.

• @shopify/polaris-icons - Exports a JavaScript file containing the Polaris icons that can be used by partners building on the Shopify platform. This package is published to the public npm registry.
• @shopify/polaris-icons-internal - Exports a JavaScript file containing the Polaris icons that are for Shopify use only. This package is published to Shopify’s private npm registry.
• @shopify/polaris-icons-raw - Contains SVG files for the Polaris icons. This is a helper package that’s imported by the polaris-icons and polaris-icons-internal packages, and is published to Shopify's private npm registry.
• @shopify/polaris-icons-audit - A command line utility that can be run by any project to generate an audit of SVG usage. This package is published to the public npm registry.
• app-icon-explorer - A Gatsby static website hosted at https://polaris-icons.shopify.com that displays the Polaris icons in the polaris-icons-raw package in an interactive, user-friendly way. This is a private package that’s not published to npm.

Implementing icons

To learn about implementing Polaris icons with Polaris React in your projects, see the @shopify/polaris-icons documentation.

To learn about the Icon component and its props, see the component documentation in Polaris.

Designing icons

To learn about best practices for designing and using Polaris icons, see the Icon design guidelines in Polaris.

Contributing 🙌

We’re always looking for contributors to help us create new icons, update exiting icons, submit feedback, or improve our documentation.

Suggest a new icon

If you can’t find the icon you need, you can suggest a new icon for us to include in the collection.

Suggest changes to an icon

If you notice an existing icon that’s out-of-date or needs improvements, you can suggest changes to that icon.

Submit feedback

We welcome your feedback about the Polaris icon explorer. Let us know about bugs, typos, or any suggestions you have that might help us to evolve this tool.

To learn more about contributing to Polaris icons, see our contributing guide. 👀

Licenses 📝

• Source code is under a custom license based on MIT. The license restricts Polaris icons usage to applications that integrate or interoperate with Shopify software or services, with additional restrictions for external, stand-alone applications.
• All icons and images are licensed under the Polaris Design Guidelines License Agreement.