---
title: MetaobjectDefinition
description: >-
Subscribe to field-level changes on the MetaobjectDefinition GraphQL Admin API
object.
api_version: 2026-10
source_url:
html: 'https://shopify.dev/docs/api/events/latest/metaobject-definition'
md: 'https://shopify.dev/docs/api/events/latest/metaobject-definition.md'
api_name: events
---
# MetaobjectDefinition
**Requires `read_metaobject_definitions` access scope.:**
Supported [actions](https://shopify.dev/docs/apps/build/events/subscribe#actions): `create`, `update`, `delete`
Subscribe to field-level changes on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) GraphQL Admin API object.
Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource 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. Calculated fields, derived fields, auto-updated timestamps, and cross-domain fields aren't available as triggers.
## shopify.app.toml
```toml
[events]
api_version = "2026-10"
[[events.subscription]]
handle = "my_metaobject-definition_event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
access {
__typename
}
}
}
"""
```
***
## Supported triggers
Field-level [triggers](https://shopify.dev/docs/api/events/latest#configuration) for `MetaobjectDefinition` subscriptions.
All triggers require the `read_metaobject_definitions` access scope. Those triggers that require additional scopes are documented where relevant. Deprecated triggers are listed last.
Subscriptions can include multiple triggers. Use the `shopify-webhook-id` header for deduplication when handling duplicate deliveries.
Custom queries aren't limited to [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition). They can query the full GraphQL Admin API.
### metaobjectDefinition.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition)
Fires when events involve the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) 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.
`metaobjectDefinition.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.access.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.access)
Fires when the [`access`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.access) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) object changes.
`metaobjectDefinition.access.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.access`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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`.
Access configuration for the metaobject definition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.access.admin[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess#field-MetaobjectAccess.fields.admin)
Fires when the [`admin`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess#field-MetaobjectAccess.fields.admin) field on the [`MetaobjectAccess`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.access.customerAccount[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess#field-MetaobjectAccess.fields.customerAccount)
Fires when the [`customerAccount`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess#field-MetaobjectAccess.fields.customerAccount) field on the [`MetaobjectAccess`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.access.storefront[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess#field-MetaobjectAccess.fields.storefront)
Fires when the [`storefront`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess#field-MetaobjectAccess.fields.storefront) field on the [`MetaobjectAccess`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectAccess) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.capabilities)
Fires when the [`capabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.capabilities) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) object changes.
`metaobjectDefinition.capabilities.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 metaobject definition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.onlineStore)
Fires when the [`onlineStore`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.onlineStore) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities) object changes.
`metaobjectDefinition.capabilities.onlineStore.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities.onlineStore`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 whether a metaobject definition can be displayed as a page on the Online Store.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.data.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesOnlineStore#field-MetaobjectCapabilitiesOnlineStore.fields.data)
Fires when the [`data`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesOnlineStore#field-MetaobjectCapabilitiesOnlineStore.fields.data) field on the [`MetaobjectCapabilitiesOnlineStore`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesOnlineStore) object changes.
`metaobjectDefinition.capabilities.onlineStore.data.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities.onlineStore.data`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 `data` field represents the data associated with the Online Store capability.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.data.urlHandle[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataOnlineStore#field-MetaobjectCapabilityDefinitionDataOnlineStore.fields.urlHandle)
Fires when the [`urlHandle`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataOnlineStore#field-MetaobjectCapabilityDefinitionDataOnlineStore.fields.urlHandle) field on the [`MetaobjectCapabilityDefinitionDataOnlineStore`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataOnlineStore) 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 `urlHandle` field represents the URL handle for accessing pages of this metaobject type in the Online Store.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.onlineStore.enabled[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesOnlineStore#field-MetaobjectCapabilitiesOnlineStore.fields.enabled)
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesOnlineStore#field-MetaobjectCapabilitiesOnlineStore.fields.enabled) field on the [`MetaobjectCapabilitiesOnlineStore`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesOnlineStore) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.publishable.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.publishable)
Fires when the [`publishable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.publishable) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities) object changes.
`metaobjectDefinition.capabilities.publishable.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities.publishable`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 metaobject definition is publishable.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.publishable.enabled[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesPublishable#field-MetaobjectCapabilitiesPublishable.fields.enabled)
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesPublishable#field-MetaobjectCapabilitiesPublishable.fields.enabled) field on the [`MetaobjectCapabilitiesPublishable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesPublishable) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.renderable)
Fires when the [`renderable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.renderable) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities) object changes.
`metaobjectDefinition.capabilities.renderable.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities.renderable`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 metaobject definition is renderable and exposes SEO data.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.data.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesRenderable#field-MetaobjectCapabilitiesRenderable.fields.data)
Fires when the [`data`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesRenderable#field-MetaobjectCapabilitiesRenderable.fields.data) field on the [`MetaobjectCapabilitiesRenderable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesRenderable) object changes.
`metaobjectDefinition.capabilities.renderable.data.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities.renderable.data`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 `data` field represents the data associated with the renderable capability.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.data.metaDescriptionKey[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataRenderable#field-MetaobjectCapabilityDefinitionDataRenderable.fields.metaDescriptionKey)
Fires when the [`metaDescriptionKey`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataRenderable#field-MetaobjectCapabilityDefinitionDataRenderable.fields.metaDescriptionKey) field on the [`MetaobjectCapabilityDefinitionDataRenderable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataRenderable) 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 `metaDescriptionKey` field represents the metaobject field used as an alias for the SEO page description.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.data.metaTitleKey[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataRenderable#field-MetaobjectCapabilityDefinitionDataRenderable.fields.metaTitleKey)
Fires when the [`metaTitleKey`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataRenderable#field-MetaobjectCapabilityDefinitionDataRenderable.fields.metaTitleKey) field on the [`MetaobjectCapabilityDefinitionDataRenderable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilityDefinitionDataRenderable) 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 `metaTitleKey` field represents the metaobject field used as an alias for the SEO page title.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.renderable.enabled[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesRenderable#field-MetaobjectCapabilitiesRenderable.fields.enabled)
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesRenderable#field-MetaobjectCapabilitiesRenderable.fields.enabled) field on the [`MetaobjectCapabilitiesRenderable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesRenderable) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.translatable.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.translatable)
Fires when the [`translatable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities#field-MetaobjectCapabilities.fields.translatable) field on the [`MetaobjectCapabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilities) object changes.
`metaobjectDefinition.capabilities.translatable.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.capabilities.translatable`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 metaobject definition is translatable.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.capabilities.translatable.enabled[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesTranslatable#field-MetaobjectCapabilitiesTranslatable.fields.enabled)
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesTranslatable#field-MetaobjectCapabilitiesTranslatable.fields.enabled) field on the [`MetaobjectCapabilitiesTranslatable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectCapabilitiesTranslatable) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.description[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.description)
Fires when the [`description`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.description) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) 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 administrative description.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.displayNameKey[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.displayNameKey)
Fires when the [`displayNameKey`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.displayNameKey) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) 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 `displayNameKey` field represents the key of a field to reference as the display name for each object.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.fieldDefinitions)
Fires when the [`fieldDefinitions`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.fieldDefinitions) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) object changes.
`metaobjectDefinition.fieldDefinitions.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.fieldDefinitions`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 `fieldDefinitions` field represents the fields defined for this object type.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.capabilities.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.capabilities)
Fires when the [`capabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.capabilities) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition) object changes.
`metaobjectDefinition.fieldDefinitions.capabilities.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.fieldDefinitions.capabilities`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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`.
Capabilities available for this metaobject field definition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinitionCapabilities#field-MetaobjectFieldDefinitionCapabilities.fields.adminFilterable)
Fires when the [`adminFilterable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinitionCapabilities#field-MetaobjectFieldDefinitionCapabilities.fields.adminFilterable) field on the [`MetaobjectFieldDefinitionCapabilities`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinitionCapabilities) object changes.
`metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable`, including nested triggers. Use a more specific trigger to limit events to the fields you need.
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 metaobject field definition is configured for filtering.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.enabled[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldCapabilityAdminFilterable#field-MetaobjectFieldCapabilityAdminFilterable.fields.enabled)
Fires when the [`enabled`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldCapabilityAdminFilterable#field-MetaobjectFieldCapabilityAdminFilterable.fields.enabled) field on the [`MetaobjectFieldCapabilityAdminFilterable`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldCapabilityAdminFilterable) 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:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.description[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.description)
Fires when the [`description`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.description) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition) 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 administrative description.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.name[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.name)
Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.name) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition) 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.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.required[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.required)
Fires when the [`required`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.required) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition) 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`.
Required status of the field within the metaobject composition.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.fieldDefinitions.validations[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.validations)
Fires when the [`validations`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition#field-MetaobjectFieldDefinition.fields.validations) field on the [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectFieldDefinition) 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 field.
**Variables:** `metaobjectDefinitionType`
### metaobjectDefinition.name[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.name)
Fires when the [`name`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.name) field on the [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/MetaobjectDefinition) 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.
**Variables:** `metaobjectDefinitionType`
### Examples
* #### Subscribe via app configuration
##### shopify.app.toml
```toml
[events]
api_version = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["create","update","delete"]
triggers = ["metaobjectDefinition.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_details($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
}
}
"""
```
##### Payload (added)
```json
{
"topic": "MetaobjectDefinition",
"action": "create",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition"
}
},
"fields_changed": {
"added": [
"metaobjectDefinition[type: 'lookbook']"
],
"updated": [],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Payload (updated)
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition"
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].access.admin"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Payload (removed)
```json
{
"topic": "MetaobjectDefinition",
"action": "delete",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": null
},
"fields_changed": {
"added": [],
"updated": [],
"removed": [
"metaobjectDefinition[type: 'lookbook']"
]
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update # or create, delete
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
access {
__typename
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"__typename": "MetaobjectAccess"
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].access.admin"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.admin"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
access {
admin
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"admin": "…"
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].access.admin"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.customerAccount"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
access {
customerAccount
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"customerAccount": "…"
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].access.customerAccount"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.access.storefront"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
access {
storefront
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"access": {
"storefront": "…"
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].access.storefront"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
__typename
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"__typename": "MetaobjectCapabilities"
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.onlineStore.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
onlineStore {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"__typename": "MetaobjectCapabilitiesOnlineStore"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.onlineStore.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.data.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
onlineStore {
data {
__typename
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"data": {
"__typename": "MetaobjectCapabilityDefinitionDataOnlineStore"
}
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.onlineStore.data.urlHandle"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.data.urlHandle"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
onlineStore {
data {
urlHandle
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"data": {
"urlHandle": "…"
}
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.onlineStore.data.urlHandle"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.onlineStore.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
onlineStore {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"onlineStore": {
"enabled": "…"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.onlineStore.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.publishable.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
publishable {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"publishable": {
"__typename": "MetaobjectCapabilitiesPublishable"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.publishable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.publishable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
publishable {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"publishable": {
"enabled": "…"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.publishable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
renderable {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"__typename": "MetaobjectCapabilitiesRenderable"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.renderable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.data.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
renderable {
data {
__typename
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"data": {
"__typename": "MetaobjectCapabilityDefinitionDataRenderable"
}
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.renderable.data.metaDescriptionKey"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.data.metaDescriptionKey"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
renderable {
data {
metaDescriptionKey
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"data": {
"metaDescriptionKey": "…"
}
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.renderable.data.metaDescriptionKey"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.data.metaTitleKey"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
renderable {
data {
metaTitleKey
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"data": {
"metaTitleKey": "…"
}
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.renderable.data.metaTitleKey"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.renderable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
renderable {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"renderable": {
"enabled": "…"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.renderable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.translatable.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
translatable {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"translatable": {
"__typename": "MetaobjectCapabilitiesTranslatable"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.translatable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.capabilities.translatable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
capabilities {
translatable {
enabled
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"capabilities": {
"translatable": {
"enabled": "…"
}
}
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].capabilities.translatable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.description"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
description
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"description": "Example
"
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].description"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.displayNameKey"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
displayNameKey
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"displayNameKey": "…"
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].displayNameKey"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
__typename
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"__typename": "MetaobjectFieldDefinition"
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.capabilities.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
capabilities {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"capabilities": {
"__typename": "MetaobjectFieldDefinitionCapabilities"
}
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.capabilities.adminFilterable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.*"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
capabilities {
adminFilterable {
__typename
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"capabilities": {
"adminFilterable": {
"__typename": "MetaobjectFieldCapabilityAdminFilterable"
}
}
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.capabilities.adminFilterable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.capabilities.adminFilterable.enabled"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
capabilities {
adminFilterable {
enabled
}
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"capabilities": {
"adminFilterable": {
"enabled": "…"
}
}
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.capabilities.adminFilterable.enabled"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.description"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
description
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"description": "Example
"
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.description"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.name"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
name
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"name": "…"
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.name"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.required"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
required
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"required": "…"
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.required"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.fieldDefinitions.validations"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
fieldDefinitions {
validations {
__typename
}
}
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition",
"fieldDefinitions": [
{
"validations": [
{
"__typename": "MetafieldDefinitionValidation"
}
]
}
]
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].fieldDefinitions.validations"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
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 = "2026-10"
[[events.subscription]]
handle = "metaobjectDefinition-event"
topic = "MetaobjectDefinition"
actions = ["update"]
triggers = ["metaobjectDefinition.name"]
uri = "https://your-app.com/events"
query = """
query metaobjectDefinition_event_payload($metaobjectDefinitionType: String!) {
metaobjectDefinition: metaobjectDefinitionByType(type: $metaobjectDefinitionType) {
id
name
}
}
"""
```
##### Payload
```json
{
"topic": "MetaobjectDefinition",
"action": "update",
"handle": "metaobjectDefinition-event",
"data": {
"metaobjectDefinition": {
"id": "gid://shopify/MetaobjectDefinition/123",
"name": "Example metaobjectdefinition"
}
},
"fields_changed": {
"added": [],
"updated": [
"metaobjectDefinition[type: 'lookbook'].name"
],
"removed": []
},
"query_variables": {
"metaobjectDefinitionType": "lookbook"
}
}
```
##### Headers
```bash
shopify-action: update
shopify-api-version: 2026-10
shopify-handle: metaobjectDefinition-event
shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
shopify-shop-domain: your-shop.myshopify.com
shopify-topic: MetaobjectDefinition
shopify-triggered-at: 2026-03-23T16:24:35.267Z
shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
```
***