---
title: Adding unique values to metafields - 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/adding-unique-values-to-metafields'
  md: 'https://shopify.dev/changelog/adding-unique-values-to-metafields.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:25:57-05:00'
  postedAt: '2024-12-11T08:00:00-05:00'
  updatedAt: '2024-12-12T09:35:08-05:00'
  effectiveAt: '2024-12-11T08:00:00-05:00'
---

December 11, 2024

Tags:

* Admin GraphQL API
* 2025-01

# Adding unique values to metafields

As of `2025-01` Admin API, you can now make metafield definitions that enforce uniqueness.

The new `uniqueValues` capability ensures that each metafield has a unique value across all resources. This is available for `single_line_text_field`, `number_integer`, `url`, and [`id`](https://shopify.dev/changelog/using-custom-ids-and-handles-in-product-and-customer-lookups). For now, this capability can only be set on metafield definitions that don’t yet have associated metafields.