---
title: >-
  Deprecation of checkout metafields in 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/deprecation-of-checkout-metafields-in-checkout-and-customer-account-ui-extensions
  md: >-
    https://shopify.dev/changelog/posts/deprecation-of-checkout-metafields-in-checkout-and-customer-account-ui-extensions.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Checkout UI
      handle: checkout-ui-api
    - displayName: Customer Accounts
      handle: customer-accounts
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  indicatesActionRequired: true
  createdAt: '2026-03-26T12:16:11-04:00'
  postedAt: '2026-04-27T11:30:00-04:00'
  updatedAt: '2026-04-27T11:33:07-04:00'
  effectiveAt: '2026-04-01T13:00:00-04:00'
---

April 27, 2026

# Deprecation of checkout metafields in checkout and customer account UI extensions

DateApril 27, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

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

As of API version 2026-04, the ability to read and write checkout metafields in checkout and customer account UI extensions has been removed. Instead, checkout metafields have been replaced by cart metafields in checkout UI extensions and order metafields in customer account UI extensions.

### Action Required

If you are using checkout metafields in older API versions, it is essential to upgrade to version 2026-04. Follow our guides to ensure a smooth transition:

* [Migrate to cart metafields in checkout UI extensions](https://shopify.dev/docs/api/checkout-ui-extensions/2026-04/upgrading-to-2026-04#migrate-to-cart-metafields)
* [Migrate to order metafields in customer account UI extensions](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-04/upgrading-to-2026-04#migrate-to-order-metafields)

Additionally, order metafield definitions now support a new capability that automatically copies values from cart metafields to order metafields upon order creation. This enhancement streamlines data management between cart and order processes. [Learn more](https://shopify.dev/docs/apps/build/metafields/use-metafield-capabilities#cart-to-order-copyable)