---
title: metafieldsDelete - Customer API
description: Deletes multiple metafields in bulk.
api_version: 2025-10
api_name: customer
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/mutations/metafieldsdelete
  md: https://shopify.dev/docs/api/customer/latest/mutations/metafieldsdelete.md
---

# metafields​Delete

mutation

Deletes multiple metafields in bulk.

## Arguments

* metafields

  [\[Metafield​Identifier​Input!\]!](https://shopify.dev/docs/api/customer/latest/input-objects/MetafieldIdentifierInput)

  required

  A list of identifiers specifying metafields to delete. At least one identifier must be specified.

***

## Metafields​Delete​Payload returns

* deleted​Metafields

  [\[Metafield​Identifier\]](https://shopify.dev/docs/api/customer/latest/objects/MetafieldIdentifier)

  List of metafield identifiers that were deleted, null if the corresponding metafield isn't found.

* user​Errors

  [\[Metafields​Delete​User​Error!\]!](https://shopify.dev/docs/api/customer/latest/objects/MetafieldsDeleteUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### metafieldsDelete reference

## Mutation Reference

```graphql
mutation metafieldsDelete($metafields: [MetafieldIdentifierInput!]!) {
  metafieldsDelete(metafields: $metafields) {
    deletedMetafields {
      # MetafieldIdentifier fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "metafields": [
    {
      "ownerId": "gid://shopify/<objectName>/10079785100",
      "namespace": "<your-namespace>",
      "key": "<your-key>"
    }
  ]
}
```