---
title: >-
  Using custom ids and handles in product and customer lookups - 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/using-custom-ids-and-handles-in-product-and-customer-lookups
  md: >-
    https://shopify.dev/changelog/using-custom-ids-and-handles-in-product-and-customer-lookups.md
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-12-06T11:27:19-05:00'
  postedAt: '2024-12-11T08:00:00-05:00'
  updatedAt: '2024-12-12T09:35:11-05:00'
  effectiveAt: '2024-12-11T08:00:00-05:00'
---

December 11, 2024

Tags:

* Admin GraphQL API
* 2025-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](https://shopify.dev/changelog/adding-unique-values-to-metafields) 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.