> Warning
> Sub-topics are deprecated as of the `2024-07` version of the Admin APIs.
>
> `metaobjects/create`, `metaobjects/delete`, `metaobjects/update` topics now require you to filters instead.
> To do this, you can update your webhook subscription by replacing `subTopic` with `filter` everywhere.
>
> Note that you must explicitly utilize each metaobject definition's name when using filters across all definitions. For example: `"filter": "type:banana" AND "type:apple"` and NOT `"filter": "type:*"`.
>
> Learn more about working with [webhook filters](/docs/apps/build/webhooks/customize/filters).

Webhook sub-topics are an extra level of grouping available for some webhook topics. Sub-topics work with topics to enable delivery of a more specific and relevant stream of webhooks to your app.

## How it works

When you subscribe to some webhook topics, your app can specify a sub-topic. Your app will then only receive webhooks for both the topic and sub-topic it subscribed to. Each topic uses its own [scheme](#topics-with-sub-topics) for allocating sub-topics. The following diagram illustrates the relationship between topics, sub-topics, webhooks, and subscriptions:

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/apps/webhooks/sub-topics/overview-7fe7a7cbddf95f215aa4cde422844eb7036170db76ee0f7009522d6a8c1b05b0.png" class="lazyload themed-image" data-alt-src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/apps/webhooks/sub-topics/overview-dark-a99793e51997e5e30b7b7356219739df3fcd5bf23e2f61fa490638e6145cc576.png" alt="An overview showing the relationship between topics, sub-topics, webhooks, and subscriptions" width="5448" height="2199"></figure>

## GraphQL mutations

Sub-topics are available in API version `2024-01` and higher. You can use the following GraphQL Admin API mutations to subscribe to a webhook with sub-topics:

- [`webhookSubscriptionCreate`](/docs/api/admin-graphql/latest/mutations/webhookSubscriptionCreate)
- [`pubSubWebhookSubscriptionCreate`](/docs/api/admin-graphql/latest/mutations/pubSubWebhookSubscriptionCreate)
- [`eventBridgeWebhookSubscriptionCreate`](/docs/api/admin-graphql/latest/mutations/eventBridgeWebhookSubscriptionCreate)

## Topics with sub-topics

The following topics support sub-topics.

### Metaobjects

- **Topics**: `metaobjects/create`, `metaobjects/update`, `metaobjects/delete`
- **Sub-topics**: Required
- **Scheme**: Sub-topics map to [metaobject definitions](/docs/apps/build/custom-data#what-are-metaobjects)
- **Format**: `type:{type}`, using the `type` of the metaobject definition
- **Considerations**:
  - For [app-owned metaobject definitions](/docs/apps/build/custom-data/ownership#create-metaobject-definitions-with-reserved-types), you can't use the `$app:{some-namespace}` shorthand when specifying a sub-topic. Use the full type value, as it appears in query responses: `app--{your-app-id}--{some-namespace}`