Shopify Script Tag 弃用：时间线、自查与迁移
更新于 2026-10-09 · 依据：Script tag deprecation（Shopify 官方） 、Storefront script tags 、Order status script tags
Script Tag 不是”以后会被淘汰”，而是已经在停用。 从 2026 年 10 月 1 日起，应用已经无法再创建或更新 Script Tag；2027 年 3 月 1 日起，Shopify 将不再把 Script Tag 注入店面页面，依赖它的应用功能会直接失效。
先区分两个名字相近的东西，别搞混：
| 名称 | 是什么 | 状态 |
|---|---|---|
| Script Tag（脚本标签） | 应用通过 API 往店面注入的远程 JavaScript | 本文主题，2027-03-01 店面停止加载 |
| Shopify Scripts | Plus 专属的 Ruby 购物车/运费/支付脚本 | 已于 2026-06-30 停止运行，见 Shopify Scripts 迁移 |
一、官方时间线（全部来自 shopify.dev）
| 日期 | 发生什么 | 影响范围 |
|---|---|---|
| 2025-02-01 | 应用不能再创建 display_scope 为 order_status 或 all 的 Script Tag | 订单状态页 |
| 2025-08-28 | Plus 店铺订单状态页上的 Script Tag 停止运行 | Plus 订单状态页 |
| 2026-08-26 | 其余所有店铺订单状态页上的 Script Tag 停止运行 | 全部订单状态页（已生效） |
| 2026-10-01 | scriptTagCreate / scriptTagUpdate 在所有 API 版本返回权限错误；REST 的 POST / PUT 同样失败。已有的 Script Tag 继续运行 | 店面（已生效） |
| 2027-03-01 | Shopify 停止向店面页面注入 Script Tag，脚本不再加载 | 店面所有页面 |
几个容易误读的点：
- 固定在旧 API 版本也躲不过——官方明确说 pin 旧版本不会推迟 10 月 1 日的限制。
- 读取和删除仍然可用，开发者可以继续审计、清理已有的 Script Tag。
- 官方曾计划在安装使用 Script Tag 的应用时给商家显示警告横幅，目前已决定暂不显示——所以商家不会在后台收到明显提醒，需要主动排查。
一句话：现在店里还在跑的 Script Tag，最多能用到 2027 年 2 月底。 新装的应用如果还靠 Script Tag，从 10 月 1 日起已经装不上那部分功能了。
二、对商家意味着什么
大多数商家不会直接接触 Script Tag，它是应用替你加的。真正的风险是：某个应用的核心功能（评论组件、弹窗、追踪像素、聊天插件等）还靠 Script Tag 加载，开发者没迁移，到 2027 年 3 月 1 日功能悄无声息地消失。
商家自查清单
- 列出所有会在店面显示内容或做追踪的应用：评论、弹窗/订阅、客服聊天、推荐商品、广告像素、热力图、徽章/倒计时等
- 打开在线商店 → 模板 → 自定义 → 应用嵌入（App embeds），看这些应用是否已经出现在这里并已开启——出现在 App embeds 里，通常说明它已经用上了新的接入方式
- 没出现在 App embeds、却在店面上能看到效果的应用，直接发工单问开发者：“你们的应用是否仍使用 Script Tag？2027-03-01 之前的迁移计划是什么？”
- 换主题时重新检查一遍：App Embed 是按主题单独开启的，换了主题需要在新主题里再打开
- 有在后台自己创建的自定义应用（Admin-created custom app），或曾把访问令牌粘贴给某个第三方服务——这类情况没有扩展可用，必须单独处理（见第四节）
红线：不要在 App Embed 还没开启前就让开发者删掉 Script Tag。 App Embed 默认是关闭的，先删旧的会出现”新旧都不工作”的空窗期。
三、开发者迁移对照表
| 你的 Script Tag 用来做什么 | 官方推荐替代 | 说明 |
|---|---|---|
| 在店面加载 JavaScript（组件、弹窗、注入内容） | App Embed Block（Theme App Extension 的一部分） | 支持 vintage 主题和 Online Store 2.0 主题；商家可在主题编辑器里看到并开关 |
| 让商家在页面指定位置放内容 | App Block | 只支持使用 JSON 模板的主题 |
| 只做数据追踪：分析、转化、用户行为 | Web Pixel | 不需要在主题编辑器激活；用 webPixelCreate 创建，需要 write_pixels 和 read_customer_events 权限 |
| 自定义订单状态页内容 | Customer Account UI Extensions | 仅限已升级的店铺；未升级店铺的视觉定制没有替代方案 |
| 订单状态页追踪 | Web Pixel | 适用于所有店铺，但不能渲染 UI |
官方给的迁移顺序
- 构建带 App Embed Block 的 Theme App Extension；
- 用 deep link 把商家直接带到主题编辑器、并预先勾选你的 App Embed；
- 确认 App Embed 在已发布主题上处于开启状态；
- 再用
scriptTagDelete删除旧的 Script Tag。
两个官方提醒：
- 新旧同时运行会加载两次脚本——分析事件可能被重复统计，UI 可能渲染两遍。上线新方案后要尽快删旧的。
- 2027-03-01 之后残留的 Script Tag 记录不再有任何效果，不删也不会出问题。
审计方法：scriptTags 查询返回的是你这个应用自己的 Script Tag。如果你给多个客户各做了一个自定义应用，需要用每个应用持有的令牌逐店查询。
原则：只做追踪的脚本，Web Pixel 是最省事的替代；要在页面上显示东西的，走 App Embed。
四、不能用扩展的应用怎么办
在 Shopify 后台直接创建的自定义应用（不是用 Shopify CLI 或 Dev Dashboard 创建的）不能使用应用扩展，因此也用不了 Theme App Extension 和 Web Pixel——Script Tag 停止后它没有基于扩展的替代方案。官方给出的处理方式：
| 谁在维护这个应用 | 怎么做 |
|---|---|
| 你自己 | 把脚本移进主题：优先用自定义 Liquid 区块，必要时用代码编辑器 |
| 代理商或外包开发者 | 由他们把脚本移进主题，或重建一个正式应用 |
| 第三方服务让你建了自定义应用并粘贴令牌 | 只能等对方发布一个真正使用 Theme App Extension 或 Web Pixel 的应用 |
注意官方特别说明的代价：脚本写进主题代码后，应用删掉它也还在；而且改主题代码会让主题脱离自动升级路径。 所以只在应用确实无法使用扩展时才这样做。
五、常见问题（FAQ）
Q：Script Tag 什么时候彻底失效？ A：店面上是 2027 年 3 月 1 日，Shopify 从这天起不再注入 Script Tag。订单状态页上的 Script Tag 更早：Plus 店铺 2025-08-28、其余店铺 2026-08-26 已经停止运行。
Q：2026 年 10 月 1 日之后，我店里现有的应用功能会坏吗？ A：不会立刻坏。 10 月 1 日的变化是应用不能再创建或更新 Script Tag，已有的会继续运行到 2027-03-01。但如果你现在新装一个仍依赖 Script Tag 的应用，那部分功能已经加不上了。
Q：开发者把应用固定在旧 API 版本，能继续用 scriptTagCreate 吗？ A：不能。 官方明确说明这个限制对所有 API 版本生效，固定旧版本不会推迟。
Q：Script Tag 和 Shopify Scripts 是一回事吗？ A：不是。 Script Tag 是应用往店面注入的 JavaScript；Shopify Scripts 是 Plus 专属的 Ruby 脚本，用来改购物车、运费和支付逻辑，已于 2026-06-30 停止运行，替代方案是 Shopify Functions。
Q：商家怎么判断某个应用是否已经迁移？ A：最直接的信号是它出现在主题编辑器的”应用嵌入”里；只做追踪的应用，可以看它是否在设置 → 客户事件里以像素形式出现。都没有的，直接问开发者要迁移计划和时间。
六、延伸阅读
- Shopify 应用体检：哪些 App 该留、哪些在拖慢店铺 — 顺手清理不用但仍在加载脚本的应用
- Shopify 数据追踪集成指南 — 追踪类脚本迁到像素与客户事件
- Shopify 结账扩展性指南 — 订单状态页与结账的扩展方式
- Shopify 应用开发指南 — Theme App Extension 与应用架构
- Shopify Scripts 迁移到 Functions — 名字相近、另一条已完成的停用线
- Shopify CLI 教程 — 用 CLI 构建和部署应用扩展
小结：Shopify Script Tag 的停用分两段：订单状态页已于 2026-08-26 全面停止，店面在 2027-03-01 停止加载，而从 2026-10-01 起应用已无法创建或更新 Script Tag，固定旧 API 版本也无效。商家要做的是排查哪些应用的店面功能还没出现在”应用嵌入”里并催开发者迁移；开发者按”显示内容走 App Embed、只做追踪走 Web Pixel、订单状态页走 Customer Account UI Extensions”的对照表迁移，先确认新方案已开启再删旧 Script Tag。后台创建的自定义应用不能用扩展，只能把脚本移进主题。以上日期以 Shopify 官方文档 当前版本为准。