---
title: >-
  Polaris web components migration guides now available for Checkout and
  Customer Account UI extensions - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/polaris-web-components-migration-guides-now-available-for-checkout-and-customer-account-ui-extensions
  md: >-
    https://shopify.dev/changelog/polaris-web-components-migration-guides-now-available-for-checkout-and-customer-account-ui-extensions.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Checkout UI
      handle: checkout-ui-api
    - displayName: Customer Accounts
      handle: customer-accounts
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-05-12T15:01:56-04:00'
  postedAt: '2026-05-13T09:30:00-04:00'
  updatedAt: '2026-05-12T17:14:19-04:00'
  effectiveAt: '2026-05-13T16:30:00-04:00'
---

May 13, 2026

Tags:

* Checkout UI
* Customer Accounts

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

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](https://shopify.dev/docs/apps/build/checkout/migrate-to-web-components#mapping-legacy-components-to-web-components) and [Customer Account](https://shopify.dev/docs/apps/build/customer-accounts/migrate-to-web-components#mapping-legacy-components-to-web-components) 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](https://shopify.dev/docs/apps/build/checkout/migrate-to-web-components)
* [Customer Account UI extensions migration guide](https://shopify.dev/docs/apps/build/customer-accounts/migrate-to-web-components)