全球适用的开发者变更要求相关应用调整事件解析和父级触发器配置，但 Classic Webhook 订阅不受影响。
Ecomwith Editorial电商情报编辑部
已核验事实
Shopify Events 的 fields_changed 将从扁平数组改为包含 added、updated、removed 三个数组的对象，开发者可分别识别新增、更新和移除的路径。
父级触发器需要在路径末尾使用 .*，例如将 product.variants 改为 product.variants.*；叶级触发器如 product.variants.price 保持不变。
Events 投递将移除 shopify-event-id 和 shopify-resource-id 两个标头；Shopify 建议将 API packages 更新到最新版本。Classic Webhook 订阅不受此次变更影响。
经营影响
事件解析器的字段结构发生变化，依赖旧版 fields_changed 数组的应用需要检查读取逻辑。
现有订阅仍可继续工作，但父级触发器在下一次部署 shopify.app.toml 时需要采用新的通配符语法；等效订阅的匹配行为和事件量不变。
编辑观察
将新增、更新和移除拆开后，应用可以减少仅为判断变化类型而发起的额外查询，但前提是下游逻辑已经按新对象结构处理。
标头移除不会自动影响所有应用；风险取决于自有代码是否读取这些标头，或是否将其作为校验所需信息。
适用范围
使用 Shopify 应用、库存同步、商品变体处理或自建自动化的全球卖家，应确认供应商或内部团队是否消费 Events，而不要仅根据是否使用 Classic Webhook 判断影响范围。
若应用依赖旧 fields_changed 结构、父级触发器旧语法或已移除标头，部署后可能需要相应兼容调整；仅使用 Classic Webhook 的流程不在本次变更范围内。
行动建议
检查自建应用和第三方集成是否读取 fields_changed、shopify-event-id 或 shopify-resource-id；若代码依赖后两个标头，安排移除相关依赖或校验逻辑。
将解析逻辑改为读取 fields_changed.added、fields_changed.updated 和 fields_changed.removed，并在下一次部署 shopify.app.toml 时，将需要覆盖父级路径的触发器改为末尾带 .* 的写法。
核对 Shopify API packages 是否为最新版本，并在部署后观察 Events 消费流程是否仍能正常处理商品及变体变化。
来源与依据
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/Product/123'].variants[id: 'gid://shopify/ProductVariant/456']" ], "updated": [], "removed": [] } } Parent triggers use an explicit wildcard To subscribe to all supported fields below a parent path, use a terminal .*, suc
Shopify Developer Changelog · single-source · 72%
核验时间: 2026年9月16日 18:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.