自2026年10月1日起,scriptTagCreate和scriptTagUpdate突变将返回用户错误,且ScriptTag REST管理API资源将拒绝POST和PUT。此弃用适用于所有API版本,包括旧版本,因此固定版本无法推迟该变更。
自2027年3月1日起,Shopify将停止向商店前端注入脚本标签。商店前端是脚本标签仍在运行的最后位置,因为它们已在订单状态页面上停止工作。如果您的应用使用脚本标签将JavaScript加载到商店中,则需要在之前进行替换。
变更内容
脚本标签(Script tag)可在不修改主题代码的情况下,在前台加载 JavaScript。2027 年 3 月 1 日之后,Shopify 将不再注入这些脚本,因此脚本标签将停止在前台加载 JavaScript。
scriptTags查询和scriptTagDelete突变继续有效,因此您可以审计并清理现有的脚本标签。
变更原因
脚本标签直接在商店前台运行 JavaScript,且不会显示在主题编辑器中,这导致商家难以查找和控制它们。应用嵌入块(App embed blocks)让商家能够在主题编辑器中获得可见性和控制权,而网络像素(Web pixels)则在沙箱环境中运行,并尊重客户隐私权限。这些替代方案使商店前端的集成对商家更加透明,对客户也更加安全。
您需要采取的操作
将每个脚本标签替换为应用嵌入块,并通过主题应用扩展程序提供。应用用户在主题编辑器中激活应用嵌入块。
如果脚本仅收集分析或转化数据,请使用网络像素代替,这不需要应用用户采取任何操作。
受影响对象
使用display_scope值为online_store的应用创建脚本标签。
具有display_scope值为order_status的脚本标签受较早的弃用政策覆盖。请参阅订单状态脚本标签。
弃用时间表
- 2026年10月1日:scriptTagCreate和scriptTagUpdate将返回用户错误。现有脚本标签将继续运行。
- 2027年3月1日:Shopify将停止向商店前端注入脚本标签。
迁移路径
应用嵌入块替代脚本标签,并通过主题应用扩展程序提供。请参阅商店前端脚本标签以了解更多信息。
相关文档
- 前台脚本标签
- 迁移至主题应用扩展

