---
title: >-
  Custom ID identifier support added to the productUpdate mutation - 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/custom-id-identifier-support-added-to-the-productupdate-mutation
  md: >-
    https://shopify.dev/changelog/custom-id-identifier-support-added-to-the-productupdate-mutation.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-03-10T17:44:24-04:00'
  postedAt: '2026-03-13T12:00:00-04:00'
  updatedAt: '2026-03-11T19:13:06-04:00'
  effectiveAt: '2026-03-11T12:00:00-04:00'
---

March 13, 2026

Tags:

* Admin GraphQL API
* 2026-04

# Custom ID identifier support added to the productUpdate mutation

You can now update products using custom identifiers with the `productUpdate` mutation. By specifying the `identifier` parameter with a `customId` field, you can update products based on unique metafield values rather than Shopify's internal product IDs. This feature is particularly beneficial for integrations where external systems use their own product identifiers, facilitating seamless data synchronization without the need to store and map Shopify product IDs.

Previously available in the `productSet` mutation, this functionality is now extended to `productUpdate`. To implement this feature, provide an `identifier.customId` object containing the `namespace`, `key`, and `value` of a unique metafield definition on the product. For more information, explore the [product model](https://shopify.dev/docs/apps/build/product-merchandising/products-and-collections) and learn how to add [product data](https://shopify.dev/docs/apps/build/product-merchandising/products-and-collections/add-data).