---
title: >-
  Automatically copy cart metafields to orders at checkout completion - 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/automatically-copy-cart-metafields-to-orders-at-checkout-completion
  md: >-
    https://shopify.dev/changelog/automatically-copy-cart-metafields-to-orders-at-checkout-completion.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-01-15T10:06:10-05:00'
  postedAt: '2026-02-04T13:15:00-05:00'
  updatedAt: '2026-02-04T14:09:17-05:00'
  effectiveAt: '2026-01-28T11:00:00-05:00'
---

February 4, 2026

Tags:

* Admin GraphQL API
* 2026-04

# Automatically copy cart metafields to orders at checkout completion

As of API version `2026-04`, order metafield definitions can copy values from cart metafields to order metafields when an order is created. You can specify which cart metafields should be carried over to orders.

The metafield value is copied if both these conditions are true:

* An order metafield definition exists with the same namespace and key as a cart metafield.
* The `cartToOrderCopyable` capability is enabled on that order metafield definition.

View [developer documentation](https://shopify.dev/docs/apps/build/metafields/use-metafield-capabilities#cart-to-order-copyable).

Cart metafields are now accessible in all APIs that interact with the buyer journey, including the Storefront API, Checkout UI extensions, Functions, and the GraphQL Admin API.

We now recommend using cart metafields instead of cart attributes and checkout metafields for custom data storage. Cart metafields offer enhanced security features, such as edit and view permissions, and app-reserved namespaces, which prevent unauthorized access by other apps.

Learn more about [metafield capabilities](https://shopify.dev/docs/apps/build/metafields/use-metafield-capabilities).