---
title: Metafield description input field removal - 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/metafield-description-field-removal'
  md: 'https://shopify.dev/changelog/posts/metafield-description-field-removal.md'
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2025-02-19T15:14:08-05:00'
  postedAt: '2025-02-27T12:00:00-05:00'
  updatedAt: '2025-02-21T12:18:05-05:00'
  effectiveAt: '2025-02-20T12:00:00-05:00'
---

February 27, 2025

# Metafield description input field removal

DateFebruary 27, 2025

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

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

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

The `description` field on metafield is being removed from the [`MetafieldInput`](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/MetafieldInput) GraphQL input object. The change will appear in `unstable` and will be included in the `2025-07` API version.

The `description` field is optional and isn't exposed to merchants. You can safely stop including the field in queries and mutations.

If you want to set or get the description of a metafield, use the `description` field on [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition).