---
title: >-
  Remove metafieldDelete in favor of metafieldsDelete - 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/remove-metafielddelete-in-favor-of-metafieldsdelete
  md: >-
    https://shopify.dev/changelog/posts/remove-metafielddelete-in-favor-of-metafieldsdelete.md
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  indicatesActionRequired: true
  createdAt: '2024-09-11T11:52:56-04:00'
  postedAt: '2024-11-05T11:46:00-05:00'
  updatedAt: '2025-10-07T18:48:30-04:00'
  effectiveAt: '2024-11-05T11:46:00-05:00'
---

November 5, 2024

# Remove `metafieldDelete` in favor of `metafieldsDelete`

DateNovember 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)

As of `2025-01` the `metafieldDelete` Admin API method is being removed. The `metafieldsDelete` method should be used instead. The former relies on the Metafield GID, while the latter takes an array of Metafield Identifiers composed of `ownerId`, `namespace`, and `key`. Note that the Metafield GID is not an option in `metafieldsDelete`.