Order metafield definitions can copy cart metafields onto orders at checkout completion
As of API version 2026-04, an order metafield definition with the cartToOrderCopyable capability copies the matching cart metafield value onto the order when it is created, replacing cart attributes and checkout metafields as the recommended custom-data path.
Read the official Shopify source01 · Source fact
What changed
As of API version 2026-04, an order metafield definition with the cartToOrderCopyable capability copies the matching cart metafield value onto the order when it is created, replacing cart attributes and checkout metafields as the recommended custom-data path.
- Published
- Feb 4, 2026
- Effective
- API version 2026-04
- Deadline
- No explicit deadline stated
02 · Business impact
Who and what may be affected
- Operators
- Agency
- Surfaces
- Admin Api, Orders Api, Cart Integrations
- Impact
- Operations, Technical
- Settlement categories
- No direct payout category identified
03 · Next action
What to check
Define order metafields with the same namespace and key as the cart metafield and enable cartToOrderCopyable so cart-scoped data reaches order processing and reporting automation.
confirmed source relationshipLast reviewed Jul 26, 2026