New Migration Guides for Checkout and Customer Account UI Extensions to Polaris Web Components
Migrate your Checkout and Customer Account UI extensions to Polaris web components by following the new migration guides and updating component usage to Preact.
Start by reviewing the Checkout UI extensions migration guide, update your components to Polaris web components, and migrate any checkout metafields to cart metafields.
Summary
Shopify has published new migration guides to help developers upgrade Checkout and Customer Account UI extensions to the latest API version and Polaris web components. The guides cover moving from React or JavaScript extension APIs to Preact, Polaris web components, and the global shopify object. More than 60 component‑specific migration pages are included, covering components such as Button, Checkbox, TextField, Banner, and View for both Checkout and Customer Account extensions. The guides also provide instructions for migrating checkout metafields to cart metafields. Extensions using an API version earlier than 2025‑10 should adopt Polaris web components, which become the default in API version 2025‑10 and later. Developers can start with the Checkout UI extensions migration guide and the Customer Account UI extensions migration guide linked in the announcement. Following these guides will ensure compatibility with the latest Shopify API and UI component standards.
Key changes
- New migration guides for Checkout and Customer Account UI extensions to Polaris web components.
- Guidance for moving from React/JS to Preact and Polaris components.
- 60+ component‑specific migration pages (Button, Checkbox, TextField, Banner, View).
- Instructions for migrating checkout metafields to cart metafields.
- Polaris web components become default in API version 2025‑10 and later.
- Guides available at Shopify docs links for Checkout and Customer Account extensions.
- Use global shopify object in new components.
- Developers should review guides to ensure compatibility with latest API.