Deprecation of checkout metafields in checkout and customer account UI extensions
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 27, 2026.
This Shopify update is categorized as Action Required, API, Deprecation announcement, Checkout UI, Customer Accounts, 2026-04.
What changed
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.
Who is affected
Developers building customer account experiences or extensions should review this change.
What action may be needed
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 Migrate to order metafields in customer account UI extensions 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.
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 →