Skip to main content
Shopify.devShopify.devDocs
Log inSign up

Shopify uses cookies to provide necessary site functionality and improve your experience. By using our website, you agree to our privacy policy and our cookie policy.

Back to Developer changelog
Admin GraphQL API2025-01

Using custom ids and handles in product and customer lookups

As of 2025-01 Admin API, you can use your own identifiers to lookup Products and Customers with the following APIs:

  • customerByIdentifier
  • productByIdentifier

Custom ids are defined by a new metafield type: id. The unique values capability is required and enabled by default for the id type. The id type unlocks custom ids for Shopify, enabling merchants and partners to specify their own identifiers for objects with metafields.

Was this section helpful?