---
title: >-
  Define and set metafields on inventory transfers in the GraphQL Admin API -
  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/define-and-set-metafields-on-inventory-transfers-in-the-admin-graphql-api
  md: >-
    https://shopify.dev/changelog/define-and-set-metafields-on-inventory-transfers-in-the-admin-graphql-api.md
metadata:
  effectiveApiVersion: 2026-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-05-25T10:36:08-04:00'
  postedAt: '2026-06-17T12:00:00-04:00'
  updatedAt: '2026-06-02T09:43:00-04:00'
  effectiveAt: '2026-06-17T12:00:00-04:00'
---

June 17, 2026

Tags:

* Admin GraphQL API
* 2026-07

# Define and set metafields on inventory transfers in the GraphQL Admin API

As of GraphQL Admin API version `2026-07`, you can define metafields for inventory transfers and set metafields directly when creating or editing transfers.

Use `MetafieldOwnerType.TRANSFER` with metafield definition mutations to create transfer-specific metafield definitions. You can also pass metafields in the `metafields` input on the following mutations:

* [`inventoryTransferCreate`](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/inventoryTransferCreate)
* [`inventoryTransferCreateAsReadyToShip`](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/inventoryTransferCreateAsReadyToShip)
* [`inventoryTransferEdit`](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/inventoryTransferEdit)

Duplicating a transfer will also duplicates its metafields on [`inventoryTransferDuplicate`](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/inventoryTransferDuplicate). This lets apps define, validate, and write transfer-specific custom data, such as ERP references, handling instructions, review teams, or other metadata, without requiring a separate `metafieldsSet` call after creating or editing a transfer.

Learn more about [metafields](https://shopify.dev/docs/apps/build/custom-data/metafields) and the [Admin GraphQL API](https://shopify.dev/docs/api/admin-graphql).