---
title: metafieldDefinitionUpdate - Shop Partners API
description: Update a MetafieldDefinition by changing its key, name, description, capabilities, or access.
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldDefinitionUpdate
  md: https://shopify.dev/docs/api/shop-partners/latest/mutations/metafieldDefinitionUpdate.md
---

# metafield​Definition​Update

mutation

Update a MetafieldDefinition by changing its key, name, description, capabilities, or access.

## Arguments

* definition

  [Metafield​Definition​Update​Input!](https://shopify.dev/docs/api/shop-partners/latest/input-objects/MetafieldDefinitionUpdateInput)

  required

***

## Metafield​Definition​Update​Payload returns

* updated​Definition

  [Metafield​Definition](https://shopify.dev/docs/api/shop-partners/latest/objects/MetafieldDefinition)

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/shop-partners/latest/objects/UserError)

  non-null

  List of errors that occured while executing the mutation.

***

## Examples

* ### metafieldDefinitionUpdate reference