---
title: >-
  Using custom ids to look up collections, locations, orders, and product
  variants - 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-ids-more-lookups'
  md: 'https://shopify.dev/changelog/custom-ids-more-lookups.md'
metadata:
  effectiveApiVersion: 2025-04
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-03-21T10:58:51-04:00'
  postedAt: '2025-03-22T12:00:00-04:00'
  updatedAt: '2025-03-21T12:01:39-04:00'
  effectiveAt: '2025-03-22T12:00:00-04:00'
---

March 22, 2025

Tags:

* API
* 2025-04

# 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](https://shopify.dev/changelog/using-custom-ids-and-handles-in-product-and-customer-lookups).