The input fields to use to create or update a metafield through a mutation on the owning resource.
An alternative way to create or update a metafield is by using the
[metafieldsSet](https://shopify.dev/api/admin-graphql/latest/mutations/metafieldsSet) mutation.
Access Scopes
Fields
description:
String -
The description of the metafield.
id:
ID -
The unique ID of the metafield. Using `owner_id`, `namespace`, and `key` is preferred for creating and updating.
key:
String -
The unique identifier for a metafield within its namespace.
Required when creating a metafield, but optional when updating. Used to help identify the metafield when
updating, but can't be updated itself.
Must be 2-64 characters long and can contain alphanumeric, hyphen, and underscore characters.
namespace:
String -
The container for a group of metafields that the metafield is or will be associated with. Used in tandem with
`key` to lookup a metafield on a resource, preventing conflicts with other metafields with the same `key`.
Required when creating a metafield, but optional when updating. Used to help identify the metafield when
updating, but can't be updated itself.
Must be 3-255 characters long and can contain alphanumeric, hyphen, and underscore characters.
type:
String -
The type of data that is stored in the metafield.
Refer to the list of [supported types](https://shopify.dev/apps/metafields/types).
Required when creating or updating a metafield without a definition.
value:
String -
The data stored in the metafield. Always stored as a string, regardless of the metafield's type.