Upgrading to 2025-10
This guide describes how to upgrade your customer account UI extension to API version 2025-10.
Anchor to migrating-to-polaris-web-componentsMigrating to Polaris web components
Set the API version to 2025-10 in shopify.extension.toml to use the new Polaris UI framework (still in early preview). Use the comparison table below to see what Polaris web components are available today and how they map to legacy components.
This is an early access preview of the Polaris UI framework. We will be adding more components over time, so please refer to the comparison table below to see which components are currently available, which ones are coming soon, and how they correspond to their legacy versions.
We advise against migrating your production customer account UI extension to Polaris until the release is stable. However, this is a great opportunity to explore the new version and start planning your migration.
Anchor to mapping-legacy-components-to-polaris-webMapping Legacy components to Polaris web
| Legacy Component | Polaris Web Component | Migration Notes |
|---|---|---|
Avatar | Avatar | Available today |
| ButtonGroup | Available today | |
Card | Section | Available today |
| CustomerAccountAction | Available today |
| ImageGroup | Available today |
Menu | Menu | Available today |
Page | Page | Available today |
| Use Section |
Anchor to additional-componentsAdditional components
In addition to the components above, you can also use Polaris web components in the Checkout library to build customer account UI extensions.
