---
title: About sub-topics
description: Use sub-topics get more precise events on metaobject webhook topics.
source_url:
  html: https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics
  md: https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics.md
---

ExpandOn this page

* [How it works](https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics#how-it-works)
* [Graph​QL mutations](https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics#graphql-mutations)
* [Topics with sub-topics](https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics#topics-with-sub-topics)

# About sub-topics

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](https://shopify.dev/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:

![An overview showing the relationship between topics, sub-topics, webhooks, and subscriptions](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/apps/webhooks/sub-topics/overview-DLwAydOG.png)

***

## Graph​QL 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`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webhookSubscriptionCreate)
* [`pubSubWebhookSubscriptionCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/pubSubWebhookSubscriptionCreate)
* [`eventBridgeWebhookSubscriptionCreate`](https://shopify.dev/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](https://shopify.dev/docs/apps/build/custom-data#what-are-metaobjects)
* **Format**: `type:{type}`, using the `type` of the metaobject definition
* **Considerations**:
  * For [app-owned metaobject definitions](https://shopify.dev/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}`

***

* [How it works](https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics#how-it-works)
* [Graph​QL mutations](https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics#graphql-mutations)
* [Topics with sub-topics](https://shopify.dev/docs/apps/build/webhooks/customize/sub-topics#topics-with-sub-topics)