已核验事实
发生了什么
Shopify 表示,自2026年10月1日起,scriptTagCreate 和 scriptTagUpdate mutation 将返回用户错误,ScriptTag REST Admin API 资源也将拒绝 POST 和 PUT 请求;该停用适用于所有 API 版本,固定旧版本不能延后影响。
自2027年3月1日起,Shopify 将停止向 Online Store 店铺前台注入 Script Tag,现有脚本将不再加载 JavaScript;受影响的主要是使用 display_scope 为 online_store 创建 Script Tag 的应用。
在2026年10月1日至2027年3月1日期间,已有 Script Tag 仍会继续运行;scriptTags 查询和 scriptTagDelete mutation 仍可用于审计和清理现有 Script Tag。
Shopify 给出的迁移路径是:将功能性脚本替换为主题应用扩展中的 App Embed Block,由商家在主题编辑器中启用;如果脚本只收集分析或转化数据,则使用 Web Pixel,且不需要商家采取启用操作。
目前可确认的信息来自 Shopify Changelog 的标题与摘要,未提供完整源文档正文,因此具体迁移配置、兼容性和测试要求仍需以 Shopify 相关开发文档为准。
经营影响
为什么重要
这不是单纯的 API 版本升级:即使应用固定使用旧 API 版本,2026年10月1日后的创建和更新请求仍会被拒绝,依赖 ScriptTag 的安装、更新或修复流程可能因此失败。
2027年3月1日后,前台脚本不会再被 Shopify 注入,可能影响由应用负责加载的前台功能,以及依赖脚本执行的分析或转化数据采集流程。
迁移方式取决于脚本用途:需要在店铺前台运行交互或功能逻辑的脚本,应转向 App Embed Block;纯数据采集脚本则应评估 Web Pixel,商家启用流程不同。
编辑观察
分析判断
最需要优先排查的不是单个脚本文件,而是应用安装、更新和卸载流程中对 ScriptTag API 的依赖,因为2026年10月1日后相关写入接口会先于前台停止注入而失效。
将所有脚本统一迁移到 App Embed Block 并不稳妥;先按“功能脚本”和“数据采集脚本”分类,更可能减少商家启用负担,也能避免为纯采集用途保留不必要的主题配置。
现有 Script Tag 在过渡期仍会运行,但这不应被视为可以延后处理的信号;迁移需要同时验证应用端注册逻辑、商家主题配置和前台实际执行结果。
适用范围
对卖家的影响
如果你的 Shopify 应用通过 display_scope 为 online_store 的 ScriptTag 加载前台 JavaScript,需要在2026年10月1日前完成新建和更新流程的替换规划,并在2027年3月1日前完成前台迁移。
如果你是使用此类应用的 Shopify 商家,需要确认应用是否要求在主题编辑器中启用 App Embed Block;迁移后若未启用,相关前台功能可能无法按预期工作。
如果脚本只负责分析或转化数据采集,应与应用方确认是否改用 Web Pixel,以及迁移后数据采集是否仍覆盖原有场景。
行动建议
现在应该做什么
- 1
盘点现有 ScriptTag
now使用 scriptTags 查询列出应用创建的现有 ScriptTag,重点标记 display_scope 为 online_store 的记录,并区分功能脚本与分析、转化数据采集脚本。
- 2
检查 API 写入依赖
this-week在应用代码、安装流程和更新流程中搜索 scriptTagCreate、scriptTagUpdate,以及 ScriptTag REST Admin API 的 POST、PUT 调用,确认是否存在依赖这些接口的自动化任务。
- 3
制定分用途迁移方案
this-week将功能性脚本规划为主题应用扩展中的 App Embed Block;将仅用于分析或转化数据采集的脚本与 Web Pixel 方案进行对照,并记录商家是否需要在主题编辑器中启用。
- 4
在店铺环境验证迁移结果
monitor迁移后分别验证前台功能、主题启用状态和数据采集结果,同时保留对现有 ScriptTag 的清单,便于在停止注入前完成清理。
暂时不要做什么
- 不要因为现有 ScriptTag 在2026年10月1日至2027年3月1日期间仍会运行,就继续依赖旧接口或等到最后阶段再迁移;也不要在未区分脚本用途、未验证替代方案前批量删除现有 ScriptTag。
来源与依据
证据与来源
- 01原始来源
Starting October 1, 2026, the scriptTagCreate and scriptTagUpdate mutations will return an user error, and the ScriptTag REST Admin API resource will reject POST and PUT. The deprecation applies to all API versions, including older ones, so pinning won't defer it. On March 1, 2027, Shopify will stop injecting script tags into storefronts. Storefronts are the last place script tags still run, since they already stopped working on the Order status page. If your app uses a script tag to load JavaScript onto a store, then you need to replace it before then. What's changing A script tag loads JavaScript on a storefront without any changes to theme code. After March 1, 2027, Shopify won't inject those scripts, so script tags will stop loading JavaScript on storefronts. The scriptTags query and the scriptTagDelete mutation keep working, so you can audit and clean up your existing script tags. What you need to do Replace each script tag with an app embed block, which you ship in a theme app extension. App users activate app embed blocks in the theme editor. If a script only collects analytics or conversion data, then use a web pixel instead, which needs no action from the app user. Who's a
Shopify Developer Changelog · single-source · 72%
核验时间: 2026年8月24日 20:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.