Polaris web components migration guides now available for Checkout and Customer Account UI extensions
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on May 13, 2026.
This Shopify update is categorized as API, Update, Checkout UI, Customer Accounts.
What changed
We’ve published new migration guides to help you upgrade Checkout and Customer Account UI extensions to the latest API version and Polaris web components. The new guides include: Guidance for moving from React or JavaScript extension APIs to Preact, Polaris web components, and the global shopify object. More than 60 component-specific migration pages, covering components such as Button, Checkbox, TextField, Banner and View for Checkout and Customer Account UI extensions. Instructions for migrating checkout metafields to cart metafields If your extension uses an API version earlier than 2025-10, use these guides to adopt Polaris web components, which are the default in API version 2025-10 and later. Start with: Checkout UI extensions migration guide Customer Account UI extensions migration guide
Who is affected
Developers building customer account experiences or extensions should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →