---
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/posts/polaris-web-components-migration-guides-now-available-for-checkout-and-customer-account-ui-extensions
  md: >-
    https://shopify.dev/changelog/posts/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

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

DateMay 13, 2026

FlagsUpdate

SurfacesAPI

Affected APIs[Checkout UI](https://shopify.dev/changelog?api_type=checkout-ui-api)[Customer Accounts](https://shopify.dev/changelog?api_type=customer-accounts)

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)