Polaris web components migration guides now available for Checkout and Customer Account UI extensions

Shopify Publishes Migration Guides for Polaris Web Components

Shopify has released comprehensive migration guides for developers updating Checkout and Customer Account UI extensions to use Polaris web components. The documentation covers the transition from React or JavaScript extension APIs to Preact, Polaris web components, and the global shopify object.

What’s Included in the Documentation

The migration guides feature over 60 component-specific pages covering UI elements including Button, Checkbox, TextField, Banner, and View. Each page provides detailed instructions for converting existing components to their Polaris web component equivalents within both Checkout and Customer Account UI extensions.

The guides address the technical requirements for moving extensions to the latest API version while adopting the new component architecture. Developers working with either extension type can reference component-specific migration paths tailored to their implementation needs.

Impact on Extension Development

Developers maintaining Checkout or Customer Account UI extensions need to plan migration work to align with Shopify’s component architecture changes. The shift to Polaris web components and Preact affects how extensions render UI elements and interact with the Shopify platform.

The documentation provides a structured approach for updating existing extensions without requiring complete rebuilds. Developers can reference component-specific guides to understand the exact changes needed for each UI element in their extensions.

Teams should review the migration guides to assess the scope of updates required for their extensions and plan implementation timelines accordingly. The component-level documentation helps identify specific technical changes needed for each part of an extension’s interface.

Read the full announcement →