The input fields required to create a metafield definition.
Access Scopes
Fields
access:
MetafieldAccessInput -
The access settings that apply to each of the metafields that belong to the metafield definition.
capabilities:
MetafieldCapabilityCreateInput -
The capabilities of the metafield definition.
constraints:
MetafieldDefinitionConstraintsInput -
The constraints that determine what resources a metafield definition applies to.
description:
String -
The description for the metafield definition.
key:
String! -
The unique identifier for the metafield definition within its namespace.
Must be 2-64 characters long and only contain alphanumeric, hyphen, and underscore characters.
name:
String! -
The human-readable name for the metafield definition.
namespace:
String -
The container for a group of metafields that the metafield definition will be associated with. If omitted, the
app-reserved namespace will be used.
Must be 3-255 characters long and only contain alphanumeric, hyphen, and underscore characters.
ownerType:
MetafieldOwnerType! -
The resource type that the metafield definition is attached to.
pin:
Boolean -
Whether to [pin](https://help.shopify.com/manual/custom-data/metafields/pinning-metafield-definitions)
the metafield definition.
type:
String! -
The type of data that each of the metafields that belong to the metafield definition will store.
Refer to the list of [supported types](https://shopify.dev/apps/metafields/types).
useAsCollectionCondition:
Boolean -
Whether the metafield definition can be used as a collection condition.
validations:
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.