---
title: MetafieldDefinitionUpdateInput - GraphQL Admin
description: The input fields required to update a metafield definition.
api_version: 2024-10
api_name: admin
type: input_object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldDefinitionUpdateInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldDefinitionUpdateInput.txt
---

# Metafield​Definition​Update​Input

input\_object

The input fields required to update a metafield definition.

## Fields

* access

  [Metafield​Access​Update​Input](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldAccessUpdateInput)

  The access settings that apply to each of the metafields that belong to the metafield definition.

* capabilities

  [Metafield​Capability​Update​Input](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldCapabilityUpdateInput)

  The capabilities of the metafield definition.

* description

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The description for the metafield definition.

* key

  [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  non-null

  The unique identifier for the metafield definition within its namespace. Used to help identify the metafield definition, but can't be updated itself.

* name

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The human-readable name for the metafield definition.

* namespace

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The container for a group of metafields that the metafield definition is associated with. Used to help identify the metafield definition, but cannot be updated itself. If omitted, the app-reserved namespace will be used.

* owner​Type

  [Metafield​Owner​Type!](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/MetafieldOwnerType)

  non-null

  The resource type that the metafield definition is attached to. Used to help identify the metafield definition, but can't be updated itself.

* pin

  [Boolean](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Boolean)

  Whether to pin the metafield definition.

* validations

  [\[Metafield​Definition​Validation​Input!\]](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/MetafieldDefinitionValidationInput)

  A list of [validation options](https://shopify.dev/apps/metafields/definitions/validation) for the metafields that belong to the metafield definition. For example, for a metafield definition with the type `date`, you can set a minimum date validation so that each of the metafields that belong to it can only store dates after the specified minimum.

### Deprecated fields

* use​As​Collection​Condition

  [Boolean](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Boolean)

  DeprecatedDefault:false

* visible​To​Storefront​Api

  [Boolean](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Boolean)

  Deprecated

***

## Mutations using this input

* [metafield​Definition​Update.​definition](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/metafieldDefinitionUpdate#argument-definition)

  MUTATION

***

## Map

### Mutations using this input

* <\~>[metafield​Definition​Update.definition](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/metafieldDefinitionUpdate#argument-definition)