Documentation on "orders/edited" vs "orders/edit" triggers

Shopify Apps

Topic summary

The discussion centers on confusion regarding which Shopify webhook triggers when order tags are added or removed.

Current Behavior:

  • Adding/removing order tags triggers orders/updated webhook
  • Does NOT trigger orders/edited webhook
  • This contradicts previous community discussions suggesting orders/edited would be more appropriate

Key Questions:

  • What specific properties/changes trigger orders/edited vs orders/updated webhooks?
  • Official documentation exists for payload structure but lacks clarity on trigger conditions

Clarification Provided:

  • orders/edited webhook fires when the OrderEdit mutation is used (typically for line items, pricing, or shipping changes)
  • Tag modifications fall outside this scope, hence only triggering orders/updated

Suggestion:

  • One participant recommends adding tag addition/removal to orders/edited webhook payload for easier change tracking
  • Ebb Order Editing app recommended for comprehensive order editing functionality

The discussion remains open regarding whether Shopify should adjust webhook behavior for tag operations.

Summarized with AI on November 3. AI used: claude-sonnet-4-5-20250929.
1

Adding or removing a Tag from an order, in my experience, triggers a “orders/updated” webhook, but not a “orders/edited” webhook.

This is in contrast to the discussion i found from last year: https://community.shopify.com/c/webhooks-and-events/webhook-tag-creation/td-p/1987847, where the last answer suggests that the edited webhook would be more appropriate.

How can we find out what triggers the “orders/edited” or “orders/updated” respectively?
I can see the content of the payload here: https://shopify.dev/docs/api/admin-rest/2024-10/resources/webhook#event-topics-orders-edited

However, I cannot find what properties would trigger a “orders/edited” webhook.

I would also suggest for the Tag addition/removal to be added to the “orders/edited” webhook, as its payload structure makes it easier to understand which were the changes that happened.

2

Order/edited happens whenever this mutation is used (https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps/edit-orders#step-3-commit-the-order-edits)

If you’re looking for a great order editing app, I can highly recommend Ebb Order Editing - http://apps.shopify.com/ebb. They handle all the edge cases with order editing for you and your customers.