Events payloads, trigger syntax and delivery headers changed

Takes effect

Not announced

Published

4 Oct 2026

Starting today, we're updating Events payloads, trigger syntax, and delivery headers. Classic Webhook subscriptions are unaffected. What's changed fields_changed now describes how each path changed The flat array becomes an object containing three arrays: added , updated , and removed . Developers can distinguish a resource or relationship being added, a value being updated, or a resource or relationship being removed without querying just to infer what happened. Update payload handling to read fields_changed.added , fields_changed.updated , and fields_changed.removed . Adding a variant to a Product, for example, keeps the Product's action as update and places the variant path in fields_changed.added . Before: { "topic": "Product", "action": "update", "fields_changed": [ "product[id: 'gid://shopify/Product/123'].variants[id: 'gid://shopify/ProductVariant/456']" ] } After: { "topic": "Product", "action": "update", "fields_changed": { "added": [ "product[id: 'gid://shopify/Produ

Read the vendor's announcement