Shopify Flow 的“产品更新”触发器以及本应用中的产品触发器
逐字段解析:Shopify Flow 的“产品更新”触发器会发送哪些数据、其五字段限制,以及哪些产品触发器会添加旧值和百分比变化。
当产品、其变体、选项或媒体的最多五个字段中的任意一个发生变化时,Shopify Flow 的“产品更新”触发器会启动一个工作流程。 Shopify 的帮助页面说明了工作流程能获取哪些数据:“‘产品更新’触发器仅提供产品及其变体、选项和媒体的当前值。”以及“发生变化的字段的先前值在工作流程中不可用。”
该应用针对每种产品变更都设置了相应的触发器,每个触发器都包含变更前后的相关值:原价、新价及价格变动百分比,用于重定向的旧链接,以及新增或移除的标签。本页面按字段逐一进行了对比。 关于 Shopify Flow 触发器的说明来自 Shopify 的帮助页面,以及我们于 2026 年 10 月 26 日和 11 月 20 日在开发商店进行的测试。
“产品更新”会发送什么内容
由“产品更新”触发的工作流程内容如下:
| 变量 | 内容 | 始终在场 |
|---|---|---|
product |
产品、当前值 | 是 |
shop |
这家店 | 是 |
productVariant |
发生变化的变量,当前值 | 仅当对变体字段进行监控且变体发生更改时 |
| 产品选项、媒体、组合列表产品 | 发生变化的项目 | 只有在对该字段进行监控时 |
它不发送的内容:
- 无历史数据。没有旧价格、旧标题、旧状态或旧标签列表。
- 没有用于分支的已更改字段列表。Shopify Flow 会在运行的步骤数据中显示已更改的路径,但在我们的测试中,这些路径并未作为变量在工作流程编辑器中提供。
- 关于变化的数据为零:没有差异、没有变化百分比、没有变化方向。

哪些已更新的产品可以观看
| 组 | 字段 |
|---|---|
| 产品 | category, combinedListingRole, descriptionHtml, giftCardTemplateSuffix, handle, metafield.value, productType, requiresSellingPlan, status, tags, templateSuffix, title, vendor |
| 变体 | variants.barcode, variants.barcodes, variants.compareAtPrice, variants.inventoryPolicy, variants.media, variants.metafield.value, variants.position, variants.price, variants.productVariantComponents, variants.requiresComponents, variants.showUnitPrice, variants.taxable, variants.title |
| 更多群组 | 媒体、选项及选项值、捆绑组件、组合列表 |
未包含在列表中:SKU、单件成本和重量(这些属于库存商品,参见Flow 的“库存项目更新”触发器,以及本应用中的 SKU、成本和库存)、单价、库存数量和销售渠道。
五字段限制
每个“产品更新”触发器可监控 1 到 5 个字段。该限制按工作流程计算,而非按商店计算:在我们的测试中,两个各包含五个字段的工作流程均在一次编辑操作中同时运行。若需监控更多字段,请创建更多工作流程,并重复设置其条件和操作。
该应用没有此类限制。每个被追踪的字段都有其专属的触发器,且通用产品更新触发器可在其设置中限定为任意数量的字段。参见 在一个工作流程中监控五个以上的字段。

逐字段
| 发生了什么变化 | Shopify Flow 产品已更新 | 此应用的触发器 | 前后对比 |
|---|---|---|---|
| 价格 | variants.price,仅限新值 |
产品变体价格已更改 | priceChange.oldPrice, newPrice, delta, percentChange, direction |
| 原价 | variants.compareAtPrice,仅限新值 |
产品变体价格已更改 | priceChange.oldCompareAtPrice, newCompareAtPrice |
| 单价 | 未在列表中(仅包含variants.showUnitPrice) |
产品变体单价已更改 | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| 单件成本 | 不适用于“产品更新”。“库存项目更新”包含unitCost,仅更新新值 |
产品变体价格已更改 | variantCostChange.oldCost, newCost, delta, percentChange, direction |
| SKU | 不包括“产品已更新”。“库存商品已更新”包含sku,仅更新新值 |
产品变体 SKU 已更改 | skuChange.oldSku, newSku |
| 条形码 | variants.barcode、variants.barcodes,仅限新值 |
产品变体条形码已更改 | 新旧主条形码、新旧条形码列表,以及新增和删除的内容 |
| 某地点的库存 | 不在列表中 | 该地点库存水平发生变化、该地点缺货、该地点恢复有货 | inventoryLevel.oldAvailable、newAvailable、delta 以及地点 |
| 标题 | title,仅限新值 |
产品名称已更改 | oldTitle, newTitle |
| 手柄 | handle,仅限新值 |
产品名称已更改 | oldHandle、newHandle,已准备好进行 URL 重定向 |
| 描述 | descriptionHtml,仅限新值 |
产品描述已更改 | oldDescription, newDescription |
| 状态 | status,仅限新值 |
产品状态已更改 | oldStatus, newStatus |
| 供应商 | vendor,仅限新值 |
产品供应商变更 | oldVendor, newVendor |
| 产品类型 | productType,仅限新值 |
产品类型已更改 | oldType, newType |
| 标签 | tags,修改后的列表 |
已添加产品标签,已移除产品标签 | addedTags, removedTags, previousTags, currentTags |
| 销售渠道 | 不在列表中 | 产品已发布到渠道,产品已从渠道下架 | channels.added, channels.removed, channels.current |
| 产品元字段 | metafield.value,仅限新值 |
产品元字段更新 | metafield.value, metafield.previousValue |
| 变体元字段 | variants.metafield.value,仅限新值 |
产品变体元字段更新 | metafield.value, metafield.previousValue |
| 在一个工作流程中包含其中几个 | 至多五个 | 产品更新,仅显示您勾选的字段 | changes.fields 和 changes.items 包含 field、oldValue、newValue,每个变体对应一个项目 |
| 选项、媒体、模板及其他产品字段 | 是的,在这五个领域内 | “产品更新”已限定为这些字段。关于这些字段在更新前后的值,请参见自定义触发器模板产品字段(更新前和更新后)。 | |
| 捆绑组件、组合列表 | 是的,在这五个领域内 | 无触发条件 |
值得了解的行为差异
- 新产品。Shopify 的帮助页面指出,根据您监控的字段不同,添加产品也可能触发工作流程:每个产品至少有一个变体,因此,当添加产品时,监控
variants.price的工作流程就会运行。该应用的触发器会记录新产品,并从其首次实际变更开始触发。 - 一个保存操作包含多个字段。Shopify Flow 的触发器仅执行一次,且不会说明是哪一个字段发生了变化。而该应用会针对每种变化类型分别触发相应的触发器,每个触发器都有各自的“变化前”和“变化后”值。
- 一个毫无改变的存档,同样无法启动。
- 回顾一下。Shopify 商店的工作流程在运行完成后会持续运行 14 天。该应用拥有自己的“事件历史记录”,其中包含每个事件的值,并且在 Shopify 管理后台的记录页面上设有“事件”模块。请参阅 事件历史记录和故障排除 和 在记录的管理页面上触发器。
需要提前获取该值的工作流程
- 当产品编号发生变化时,将旧 URL 重定向。重定向路径为从
oldHandle到newHandle。如果没有旧产品编号,就无法进行重定向。当产品标识符发生变化时,将旧的产品 URL 重定向 - 标记一个真正的 Markdown 标签。
priceChange.percentChange值小于或等于-10,可将 10% 的价格下跌与其他所有价格修改区分开来。当某款产品的变体价格下降10%或以上时,为其添加标签 - 将商品标记为促销,然后取消该标记。原价字段原本为空,现已设置;或者情况相反。添加“原价”时,将商品标记为“促销中” 和 当“原价”被移除时,请移除促销标签
- 标记新品。当产品的状态发生变化,且
oldStatus等于draft、newStatus等于active时,该条件为真 - 这仅在产品正式上线时成立,而当已归档的产品被恢复时则不成立。当产品状态变为“已上线”时,为其添加新品标签 - 保留之前的标题或 SKU。当产品标题发生变化时,保存之前的标题 和 当变体 SKU 发生变化时,保留之前的 SKU
- 在产品从销售渠道下架时发出通知。当产品在在线商店中被设为“未发布”时,为其添加标签
该用哪一个
- Shopify Flow 产品更新:您只需知道多达五个字段中有一个发生了变化,或者关注选项、媒体、捆绑组件或组合列表即可。
- 这款应用适合以下场景:您需要在一个工作流程中对比价格变动(降价、产品更名、标签移除)前后的情况;需要在同一界面查看各地点或销售渠道的SKU、成本和库存;或者需要在单个工作流程中监控五个以上的字段。
两者都可以在同一家商店中运行。
“产品更新”会显示原价格吗?
不,Shopify 的帮助页面指出,该触发器仅提供当前值。“产品变体价格变更”触发器会携带原价格、新价格、差额、百分比变化以及变化方向。
创建产品时,“产品更新”功能会运行吗?
可以。Shopify 的帮助页面指出,当添加产品时,监控变体字段(如 variants.price)的工作流程会运行,因为每个产品至少有一个变体。而在添加产品时设置标题或标签等产品字段,则不会触发该工作流程。
“产品更新”功能可以监控 SKU 还是成本?
不在产品上。Shopify 将这两项都放在了库存条目中:“库存条目更新”触发器可以监听 sku 和 unitCost,同样仅包含当前值。“产品变体 SKU 变更”和“产品变体成本变更”则包含变更前后的值。
如何仅对达到一定幅度的价格下跌做出反应?
使用“产品变体价格变更”功能,并设置priceChange.percentChange的条件,例如小于或等于-10。该应用会自动计算百分比,因为 Shopify Flow 无法进行计算。
下一步
- 产品触发器,分步指南 和 产品变体触发器,分步指南 - 每个产品和变体触发器均附有示例。
- Shopify Flow 的更新版触发器和 Workflow Trigger Extensions - 所有九个更新触发器的概述。
- 新旧值:工作流程能如何利用它们 - 按触发器分类,显示触发前后所有值。
