---
title: PrivateMetafield is now deprecated - 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/privatemetafield-is-now-deprecated'
  md: 'https://shopify.dev/changelog/privatemetafield-is-now-deprecated.md'
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Webhook
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2024-11-26T09:33:45-05:00'
  postedAt: '2024-12-05T09:15:00-05:00'
  updatedAt: '2024-12-05T09:18:24-05:00'
  effectiveAt: '2024-12-05T09:15:00-05:00'
---

December 5, 2024

Tags:

* Action Required
* Admin GraphQL API
* Webhook
* 2025-01

# PrivateMetafield is now deprecated

Starting in API version **2025-01**, PrivateMetafield will be removed from the GraphQL Admin API. Use [app-data metafields](https://shopify.dev/docs/apps/build/custom-data/metafields/use-app-data-metafields) instead. If the metafield is needed per resource, consider the [migration guide](https://shopify.dev/docs/apps/build/custom-data/metafields/migrate-private-metafields) for using app-reserved namespaces.