2026年10月1日から新規作成・更新が不可、2027年3月1日から Shopify がストアフロントに script tag を注入しなくなる。API バージョンを固定しても先送りできない。テーマアプリ拡張の App embed block か Web pixel への置き換えが必要。
scriptTagCreate / scriptTagUpdate が user error を返す。REST Admin API の ScriptTag リソースは POST と PUT を拒否する。既存の script tag はこの時点ではまだ動く。
Shopify がストアフロントに script tag を注入しなくなる。アプリが script tag で JavaScript を読み込んでいるなら、それまでに置き換えが必要。
scriptTagCreateuser error を返すようになる。新規の script tag を作成できない。
scriptTagUpdateuser error を返すようになる。既存 script tag の書き換えができない。
ScriptTag の POST / PUTREST Admin API のリソース側も作成・更新を拒否する。
scriptTags クエリ引き続き動作する。既存の script tag を洗い出す監査に使える。
scriptTagDelete ミューテーション引き続き動作する。移行後に不要になった script tag を削除できる。
| 対象 | 今回の廃止の扱い | やること |
|---|---|---|
display_scope: online_store の script tag を作るアプリ |
今回の対象 | App embed block、または Web pixel へ置き換え |
display_scope: order_status の script tag |
別（先行）の廃止でカバー済み | 先行する「Order status script tags」の案内を参照 |
| script tag を使っていないアプリ | 影響なし | — |
script tag の置き換えは App embed block。theme app extension として同梱して配布し、アプリ利用者がテーマエディタで有効化する。
スクリプトがアナリティクスやコンバージョンのデータ収集だけをしているなら Web pixel を使う。アプリ利用者側の操作は不要。
scriptTags で洗い出すクエリは廃止後も動くので、どのストアにどんな script tag が残っているかを一覧化する。
UI・機能なら theme app extension の App embed block、計測だけなら Web pixel に載せ替える。
scriptTagDelete移行が済んだストアから既存の script tag を削除する。削除ミューテーションは残る。
廃止は古いものを含むすべての API バージョンに適用される。「安定版を pin しているから猶予がある」という通常の破壊的変更の前提が、今回は通用しない。
Create / Update は user error になるが、scriptTags クエリと scriptTagDelete は動き続ける。監査とクリーンアップの導線は残る設計になっている。
GraphQL の scriptTagCreate / scriptTagUpdate だけでなく、REST Admin API の ScriptTag リソースの POST / PUT も拒否される。REST 実装のレガシーアプリも同じ期日で影響を受ける。
3月まで既存は動くが、10月以降は新規ストアに script tag を配れない。新規インストールが継続するアプリでは、10月時点で移行版の配布が始まっていないと機能欠落のストアが生まれる。
App embed block は theme app extension で配布し、アプリ利用者がテーマエディタで有効化する。一方、計測だけの用途で使える Web pixel はアプリ利用者の操作を必要としない。同じ「script tag からの移行」でも、有効化率のリスクを負うかどうかが変わるため、用途の切り分けは移行計画の最初にやる。
scriptTags クエリで全インストール先の script tag を機械的に一覧化 → display_scope が online_store のものを今回の対象として抽出 → 用途（UI か計測か）でラベリングして移行先を割り当てる。scriptTags クエリと scriptTagDelete は廃止後も動くため、棚卸しと削除のバッチは 2026年10月1日以降に作っても間に合う。ただし置き換え実装は間に合わない。scriptTags クエリで旧 script tag が残っているストアを定期的に抽出し、未移行ストアだけに再案内する。scriptTags クエリと scriptTagDelete は残る。」