---
title: MetafieldDefinition
description: >-
  Subscribe to field-level changes on the MetafieldDefinition GraphQL Admin API
  object.
api_version: unstable
source_url:
  html: 'https://shopify.dev/docs/api/events/latest/metafield-definition'
  md: 'https://shopify.dev/docs/api/events/latest/metafield-definition.md'
api_name: events
---

# Metafield​Definition

**Requires \`read\_content\` access scope.:**

Subscribe to field-level changes on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetafieldDefinition) GraphQL Admin API object. You can subscribe to create, delete, and update events, and to changes to specific fields.

Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource, such as a metafield definition, that can exist independently within its domain. Child entities that depend on a parent within the same domain don't have their own topic. Instead, changes to child entities trigger a delivery on the parent topic.

You can't use calculated fields, derived fields, auto-updated timestamps, or cross-domain fields as triggers.

Subscriptions can include multiple triggers. Use the `shopify-webhook-id` header for deduplication when handling duplicate deliveries.

You can use custom queries to query the full GraphQL Admin API, not only [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetafieldDefinition).

## shopify.app.toml

```toml
[events]
api_version = "unstable"


[[events.subscription]]
handle = "my_metafield_definition_events"


topic = "MetafieldDefinition"
actions = ["update"]
triggers = [
    "metafieldDefinition.name",
    "metafieldDefinition.validationStatus"
]


uri = "https://your-app.com/events"


query = """
query metafield_definition_details(
  $metafieldDefinitionKey: String!
  $metafieldDefinitionNamespace: String!
  $metafieldDefinitionOwnerType: MetafieldOwnerType!
) {
  metafieldDefinition(
    identifier: {
      key: $metafieldDefinitionKey
      namespace: $metafieldDefinitionNamespace
      ownerType: $metafieldDefinitionOwnerType
    }
  ) {
        id
        key
        name
        namespace
        ownerType
        validationStatus
      }
}
"""
```

***

## Supported triggers

`MetafieldDefinition` subscriptions support the following field-level [triggers](https://shopify.dev/docs/api/events/latest#configuration).

### metafieldDefinition

Fires when events involve the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object.

The `"create"` and `"delete"` actions are only relevant within the context of this parent topic. Use `fields_changed` to follow or replicate impacted data after a delete event. Define a custom query to retrieve specific fields from create events.

Collect details about changes to the object by subscribing to the trigger along with the `"update"` action, though it's recommended that you narrow your subscription to one of the other triggers below.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.access

Fires when the [`access`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.access) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `access` field represents the access settings associated with the metafield definition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.access​.admin

Fires when the [`admin`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldAccess#field-MetafieldAccess.fields.admin) field on the [`MetafieldAccess`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldAccess) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `admin` field represents the access permitted on the Admin API.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.access​.customerAccount

Fires when the [`customerAccount`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldAccess#field-MetafieldAccess.fields.customerAccount) field on the [`MetafieldAccess`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldAccess) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `customerAccount` field represents the access permitted on the Customer Account API.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.access​.storefront

Fires when the [`storefront`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldAccess#field-MetafieldAccess.fields.storefront) field on the [`MetafieldAccess`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldAccess) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `storefront` field represents the access permitted on the Storefront API.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities

Fires when the [`capabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.capabilities) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `capabilities` field represents the capabilities of the metafield definition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.adminFilterable

Fires when the [`adminFilterable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities#field-MetafieldCapabilities.fields.adminFilterable) field on the [`MetafieldCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicate whether a metafield definition is configured for filtering.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.adminFilterable​.enabled

Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityAdminFilterable#field-MetafieldCapabilityAdminFilterable.fields.enabled) field on the [`MetafieldCapabilityAdminFilterable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityAdminFilterable) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicates if the capability is enabled.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.adminFilterable​.status

Fires when the [`status`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityAdminFilterable#field-MetafieldCapabilityAdminFilterable.fields.status) field on the [`MetafieldCapabilityAdminFilterable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityAdminFilterable) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Determines the metafield definition's filter status for use in admin filtering.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.analyticsQueryable

Fires when the [`analyticsQueryable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities#field-MetafieldCapabilities.fields.analyticsQueryable) field on the [`MetafieldCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicate whether a metafield definition can be queried in analytics.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.analyticsQueryable​.enabled

Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityAnalyticsQueryable#field-MetafieldCapabilityAnalyticsQueryable.fields.enabled) field on the [`MetafieldCapabilityAnalyticsQueryable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityAnalyticsQueryable) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicates if the capability is enabled.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.cartToOrderCopyable

Fires when the [`cartToOrderCopyable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities#field-MetafieldCapabilities.fields.cartToOrderCopyable) field on the [`MetafieldCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `cartToOrderCopyable` field represents the capability configuration for automatically copying values from a cart metafield to the corresponding order metafield when an order is created.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.cartToOrderCopyable​.enabled

Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityCartToOrderCopyable#field-MetafieldCapabilityCartToOrderCopyable.fields.enabled) field on the [`MetafieldCapabilityCartToOrderCopyable`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityCartToOrderCopyable) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicates if the capability is enabled.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.smartCollectionCondition

Fires when the [`smartCollectionCondition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities#field-MetafieldCapabilities.fields.smartCollectionCondition) field on the [`MetafieldCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicate whether a metafield definition can be used as a smart collection condition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.smartCollectionCondition​.enabled

Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilitySmartCollectionCondition#field-MetafieldCapabilitySmartCollectionCondition.fields.enabled) field on the [`MetafieldCapabilitySmartCollectionCondition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilitySmartCollectionCondition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicates if the capability is enabled.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.uniqueValues

Fires when the [`uniqueValues`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities#field-MetafieldCapabilities.fields.uniqueValues) field on the [`MetafieldCapabilities`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilities) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicate whether the metafield values for a metafield definition are required to be unique.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.capabilities​.uniqueValues​.enabled

Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityUniqueValues#field-MetafieldCapabilityUniqueValues.fields.enabled) field on the [`MetafieldCapabilityUniqueValues`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldCapabilityUniqueValues) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Indicates if the capability is enabled.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.constraints

Fires when the [`constraints`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.constraints) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `constraints` field represents the constraints that determine what subtypes of resources a metafield definition applies to.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.description

Fires when the [`description`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.description) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `description` field represents the description of the metafield definition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.name

Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.name) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `name` field represents the human-readable name of the metafield definition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.pinnedPosition

Fires when the [`pinnedPosition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.pinnedPosition) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `pinnedPosition` field represents the position of the metafield definition in the pinned list.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.validationStatus

Fires when the [`validationStatus`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.validationStatus) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `validationStatus` field represents the validation status for the metafields that belong to the metafield definition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### metafieldDefinition​.validations

Fires when the [`validations`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition#field-MetafieldDefinition.fields.validations) field on the [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetafieldDefinition) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `validations` field contains a list of validation options for the metafields that belong to the metafield definition.

**Variables:** `metafieldDefinitionKey`, `metafieldDefinitionNamespace`, `metafieldDefinitionOwnerType`

### Examples

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["create"]
  triggers = ["metafieldDefinition"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_details($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "create",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition"
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123']"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: create
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.access"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      access {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "access": {
          "__typename": "MetafieldAccess"
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].access"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.access.admin"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      access {
        admin
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "access": {
          "admin": "…"
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].access.admin"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.access.customerAccount"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      access {
        customerAccount
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "access": {
          "customerAccount": "…"
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].access.customerAccount"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.access.storefront"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      access {
        storefront
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "access": {
          "storefront": "…"
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].access.storefront"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "__typename": "MetafieldCapabilities"
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.adminFilterable"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        adminFilterable {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "adminFilterable": {
            "__typename": "MetafieldCapabilityAdminFilterable"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.adminFilterable"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.adminFilterable.enabled"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        adminFilterable {
          enabled
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "adminFilterable": {
            "enabled": "…"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.adminFilterable.enabled"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.adminFilterable.status"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        adminFilterable {
          status
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "adminFilterable": {
            "status": "…"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.adminFilterable.status"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.analyticsQueryable"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        analyticsQueryable {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "analyticsQueryable": {
            "__typename": "MetafieldCapabilityAnalyticsQueryable"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.analyticsQueryable"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.analyticsQueryable.enabled"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        analyticsQueryable {
          enabled
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "analyticsQueryable": {
            "enabled": "…"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.analyticsQueryable.enabled"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.cartToOrderCopyable"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        cartToOrderCopyable {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "cartToOrderCopyable": {
            "__typename": "MetafieldCapabilityCartToOrderCopyable"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.cartToOrderCopyable"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.cartToOrderCopyable.enabled"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        cartToOrderCopyable {
          enabled
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "cartToOrderCopyable": {
            "enabled": "…"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.cartToOrderCopyable.enabled"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.smartCollectionCondition"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        smartCollectionCondition {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "smartCollectionCondition": {
            "__typename": "MetafieldCapabilitySmartCollectionCondition"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.smartCollectionCondition"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.smartCollectionCondition.enabled"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        smartCollectionCondition {
          enabled
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "smartCollectionCondition": {
            "enabled": "…"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.smartCollectionCondition.enabled"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.uniqueValues"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        uniqueValues {
          __typename
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "uniqueValues": {
            "__typename": "MetafieldCapabilityUniqueValues"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.uniqueValues"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.capabilities.uniqueValues.enabled"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      capabilities {
        uniqueValues {
          enabled
        }
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "capabilities": {
          "uniqueValues": {
            "enabled": "…"
          }
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].capabilities.uniqueValues.enabled"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.constraints"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      constraints {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "constraints": {
          "__typename": "MetafieldDefinitionConstraints"
        }
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].constraints"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.description"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      description
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "description": "<p>Example</p>"
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].description"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.name"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition"
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].name"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.pinnedPosition"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      pinnedPosition
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "pinnedPosition": "…"
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].pinnedPosition"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.validationStatus"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      validationStatus
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "validationStatus": "…"
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].validationStatus"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "unstable"

  [[events.subscription]]
  handle = "metafieldDefinition-event"

  topic = "MetafieldDefinition"
  actions = ["update"]
  triggers = ["metafieldDefinition.validations"]

  uri = "https://your-app.com/events"

  query = """
  query metafieldDefinition_event_payload($metafieldDefinitionId: ID!) {
    metafieldDefinition(id: $metafieldDefinitionId) {
      id
      name
      validations {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "MetafieldDefinition",
    "action": "update",
    "handle": "metafieldDefinition-event",
    "data": {
      "metafieldDefinition": {
        "id": "gid://shopify/MetafieldDefinition/123",
        "name": "Example metafielddefinition",
        "validations": [
          {
            "__typename": "MetafieldDefinitionValidation"
          }
        ]
      }
    },
    "fields_changed": [
      "metafieldDefinition[id: 'gid://shopify/MetafieldDefinition/123'].validations"
    ],
    "query_variables": {
      "metafieldDefinitionKey": "example-metafieldDefinitionKey",
      "metafieldDefinitionNamespace": "example-metafieldDefinitionNamespace",
      "metafieldDefinitionOwnerType": "example-metafieldDefinitionOwnerType"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: unstable
  shopify-event-id: 44444444-4444-4444-4444-444444444444
  shopify-handle: metafieldDefinition-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-resource-id: gid://shopify/MetafieldDefinition/123
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: MetafieldDefinition
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

***