Identifier support added to the productUpdate mutation
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 01, 2026.
This Shopify update is categorized as API, Update, Admin GraphQL API, 2026-04.
What changed
The productUpdate mutation now accepts an identifier argument, allowing you to look up the product to update by id, handle, or customId instead of passing the product ID inside the input. The id and handle identifiers let you specify a product's global ID or handle directly. The customId identifier lets you reference a product by a unique metafield value using a namespace, key, and value combination, enabling workflows where external systems identify products by their own IDs.
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 →