Define and set metafields on inventory transfers in the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on June 17, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-07.
What changed
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 inventoryTransferCreateAsReadyToShip inventoryTransferEdit Duplicating a transfer will also duplicates its metafields on 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 and the Admin GraphQL API.
Who is affected
Apps that read, write, translate, or depend on Shopify metafields should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
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 →