---
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/posts/privatemetafield-is-now-deprecated'
  md: 'https://shopify.dev/changelog/posts/privatemetafield-is-now-deprecated.md'
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Events & webhooks
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  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

# PrivateMetafield is now deprecated

DateDecember 5, 2024

Version[2025-01](https://shopify.dev/changelog?api_version=2025-01)

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

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.