---
title: >-
  Webhook subscriptions now support a name field for identification - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/webhook-subscriptions-now-support-a-name-field-for-identification
  md: >-
    https://shopify.dev/changelog/webhook-subscriptions-now-support-a-name-field-for-identification.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Webhook
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-02-10T11:55:01-05:00'
  postedAt: '2026-02-11T12:00:00-05:00'
  updatedAt: '2026-02-10T16:15:47-05:00'
  effectiveAt: '2026-02-11T12:00:00-05:00'
---

February 11, 2026

Tags:

* Admin GraphQL API
* Webhook
* 2026-04

# Webhook subscriptions now support a name field for identification

You can now assign an optional name to your webhook subscriptions to simplify identification and management. This feature is available for both TOML-based subscriptions and subscriptions created through the Admin API subscriptions created via the GraphQL Admin API.

Naming your webhooks is particularly beneficial when you have multiple subscriptions targeting the same endpoint or listening to the same topic with different filters. When a webhook is delivered, its name is included in the request headers, allowing you to route and process incoming webhooks without needing to parse the payload body.

For admin API subscriptions, the webhook name must be unique per shop. For declarative subscriptions, the name must be unique per app. Names can be up to 50 characters long and may include alphanumeric characters, underscores, and hyphens.

To set a name for TOML-based subscriptions, update the `name` field in your `shopify.app.toml` webhook configuration. From `2026-04`, you can name admin API subscriptions, the `name` field can be set using the [WebhookSubscription](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/WebhookSubscription) GraphQL object, as well as through the [webhookSubscriptionCreate](https://shopify.dev/docs/api/admin-graphql/2026-04/mutations/webhookSubscriptionCreate) and [webhookSubscriptionUpdate](https://shopify.dev/docs/api/admin-graphql/2026-04/mutations/webhookSubscriptionUpdate) mutations.