Using custom ids to look up collections, locations, orders, and product variants

As of 2025-04 Admin API, you can use your own identifiers to lookup more resource types with the following APIs:

• collectionByIdentifier
• locationByIdentifier
• orderByIdentifier
• productVariantByIdentifier

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.

Support for product and customer lookup by custom id was announced as part of the 2025-01 API release.