アプリをインストールした。管理画面には表示されている。課金も始まっている。それなのに、ストアを開いても何も変わっていない。

Shopifyでかなり頻繁に起きるこの状況には、原因のパターンがほぼ決まっています。しかもそのほとんどが、アプリの不具合ではなくShopifyの仕様です。

Shopifyヘルプセンターによれば、アプリがテーマと連携する方法は3種類あります。アプリブロック、アプリ埋め込み、そしてテーマコードへの直接追加です。この3つは見た目の役割が違うだけでなく、使えるテーマの条件が違い、初期状態が違い、アンインストールしたときに残るものが違います。

「アプリが表示されない」の答えは、たいてい自分のアプリがこの3つのどれなのかを特定するところから出てきます。この記事では、その判別方法と、アプリ選定時にこの違いをどう評価すべきかを整理します。調査日は2026年9月1日です。

先に結論

チャットウィジェットや解析タグのような、位置を指定しないタイプのアプリが動かないなら、アプリ埋め込みが無効のままである可能性が最も高いです。Shopify公式は「アプリ埋め込みブロックは、アプリのインストール後に既定で無効になっています」と明記しています。テーマエディタの「アプリ埋め込み」からトグルをオンにする必要があります。

商品ページのサイズガイドやレビュー表示のような、位置を指定するタイプが追加できないなら、テーマのアーキテクチャがVintageである可能性があります。アプリブロックはOnline Store 2.0以降のテーマでしか使えません。

テーマを新しくしたらアプリが全部消えたなら、正常な挙動です。Shopify公式は「アプリをインストールした後に公開テーマを変更した場合、新しいテーマでは既定で有効になっていないため、それらのアプリを再度有効化する必要があります」と明記しています。

アンインストールしたのにコードが残っているなら、そのアプリがテーマアプリ拡張機能ではなく、テーマコードへの直接追加方式だった可能性があります。この違いはアプリ選定時に確認できます。

3つの連携方式の違い

アプリブロック

セクション内のブロックとして、あるいはテンプレート内のセクションとして、テーマの任意の位置にアプリの機能を配置する方式です。テーマエディタから追加・削除・並び替え・カスタマイズができます。

商品ページに表示するレビュー、サイズチャート、バッジなど、「どこに出すか」が重要な機能はこの方式になります。

使えるテーマに条件があります。 Shopifyヘルプセンターは「アプリブロックは互換性のあるテーマでのみ使用できます」としており、テーマアーキテクチャの機能比較表では、アプリブロックとアプリ埋め込みを含む「拡張されたアプリのサポート」がVintageテーマでは非対応（✘）と明示されています。

さらに細かい制約として、Online Store 2.0テーマであっても、すべてのセクションがアプリブロックに対応しているとは限りません。対応しているセクションでは、ブロック選択メニューに「アプリ」の項目が現れます。現れない場合は、そのセクションが非対応です。どのセクションが対応しているかはテーマ側の実装によるため、テーマのドキュメントを確認するか、テーマ開発元に問い合わせる必要があります。

アプリ埋め込み

テーマ上にフロート表示・オーバーレイ表示される要素や、顧客からは見えない形でコードを追加する要素です。画面の隅に出るチャットバブル、解析・トラッキング系のスクリプトなどがこれにあたります。

アプリブロックと違い、すべてのテーマバージョンで使えます。 Vintageテーマでも動きます。

ただしここでShopify公式ドキュメントの記述が食い違っています。前述のテーマアーキテクチャ比較表は「アプリブロックとアプリ埋め込みを含む拡張されたアプリのサポート」をVintageで非対応としているのに、アプリの解説ページとshopify.devは「アプリ埋め込みブロックはどのテーマバージョンでも使用できます」と明記しています。比較表のほうが粗い書き方をしていると読むのが妥当ですが、Vintageテーマでアプリ埋め込みが動くかどうかを事前に確定させたい場合は、アプリの開発元に直接確認することをおすすめします。

その代わり、初期状態は無効です。 テーマエディタのサイドバーにある「アプリ埋め込み」アイコンから、対象のアプリのトグルをオンにして保存する必要があります。ここを知らないと、「対応テーマなのに動かない」という状況になります。

なお、複数のマーケットを運用している場合、アプリ埋め込みはマーケットごとにカスタマイズできます。北米マーケットだけチャットアプリを有効にする、といった設定が可能です。テーマエディタでマーケットを選択してから有効化・設定します。

テーマコードへの直接追加

アプリがテーマのコードに直接コードを注入する方式です。インストール後の案内で、テーマコードを自分で編集して機能を追加する手順が示されることがあります。

テーマがカスタムLiquidセクションに対応していれば、テーマコードを直接編集する代わりに、そこへアプリのコードを貼る方法も取れます。

この方式が、アンインストール時の残骸の原因になります。

自分のテーマがどちらか調べる

アプリブロックが使えるかどうかは、テーマのアーキテクチャバージョンで決まります。Shopify公式が案内している判別手順は次のとおりです。

1. 管理画面から「オンラインストア」へ移動する
2. 対象のテーマで「テーマをカスタマイズ」を開く
3. 「商品」>「デフォルト商品」を選び、デフォルトの商品テンプレートを開く
4. サイドバーのセクション一覧の下に「セクションを追加」ボタンがあるか確認する

このボタンがあれば、すべてのページでセクションに対応したテーマ、つまりOnline Store 2.0以降です。なければVintageテーマです。

Vintageテーマにはさらに「セクション対応」と「セクション非対応」の区別があります。テーマコードを編集する画面でSectionsディレクトリにファイルがあればセクション対応、なければ非対応です。

もう1つ注意点があります。Shopify公式は「一部のケースでは、テーマの一部が対応していて他が対応していないことがあります」と明記しています。商品テンプレートではセクションの追加・削除ができるのに、コレクションテンプレートではできない、といった状態です。これはJSONテンプレートが一部のページにしか用意されていない場合に起きます。テーマを部分的にしか移行していない場合や、Theme Store外で入手したテーマで開発元が全ページ分のJSONテンプレートを含めていない場合が該当します。

なお、VintageテーマはShopify Theme Storeでは提供されていません。Shopifyが提供する無料のVintageテーマは、セキュリティ修正以外の更新を受けません。アプリの互換性という観点でも、テーマ移行の検討材料になります。

アンインストール時に残るもの、残らないもの

ここがアプリ選定の実務に直結します。

Shopify公式の開発者ドキュメントによれば、テーマアプリ拡張機能で作られたアプリはテーマコードを編集しません。アセット（CSS・JavaScript等）はShopifyのCDNでホストされ、テーマファイルには書き込まれません。この設計により、テーマに破壊的な変更を持ち込むリスクが下がります。

一方、テーマコードへ直接コードを注入する方式のアプリは、アンインストールしてもそのコードが自動では消えません。Shopifyヘルプセンターのアンインストール手順には、次の注意書きがあります。

一部のアプリは、アンインストール時に自動的には削除されないコードをオンラインストアのテーマに追加します。アンインストールする前に、Shopify App Storeのアプリ掲載ページを確認するか、アプリ開発元に問い合わせて、追加の手順が必要かどうかを確認してください。

つまりShopify自身が「消えないことがあるので事前に確認せよ」と案内しています。

構造的な理由もあります。開発者コミュニティでは、アプリのアンインストールを通知するWebhookが発火した時点で既にAdmin APIのセッションが失効しているため、アプリ側が自分で追加したテーマファイルを削除できない、という説明がなされています。開発元の怠慢というより、アーキテクチャ上そうなっているという話です。

アンインストール時の考慮事項として、Shopifyは他にも次の点を挙げています。

• 有料アプリのアンインストールは今後の継続課金を停止するが、現在の請求サイクル分は請求される可能性がある
• Shopifyの外で課金する外部請求は、アンインストールしても止まらない
• アプリがロケーションに在庫を保持している場合、在庫の移動または削除が必要になる
• アプリに依存する自動化・連携・機能はすべて停止する
• アプリが保持しているデータは復元できない場合がある
• 再インストールしても以前の設定やデータが戻るとは限らない

スクリプトタグは2027年3月1日に止まる

古い連携方式には期限が設定されています。

Shopifyの開発者向けChangelogは、スクリプトタグが非推奨であり、2027年3月1日に動作を停止すると告知しています。アプリがスクリプトタグでストアフロントにJavaScriptを読み込んでいる場合、それまでに置き換えが必要です。

重要なのは、この非推奨がすべてのAPIバージョンに適用される点です。古いAPIバージョンに固定していても先送りできません。

しかも締切は2段階です。停止の半年前、2026年10月1日の時点で、scriptTagCreate と scriptTagUpdate はユーザーエラーを返すようになり、ScriptTagのREST Admin APIリソースはPOSTとPUTの操作を拒否します。既存のスクリプトタグは2027年3月1日まで動き続けますが、新規作成と更新はその5か月前に止まります。

置き換え先はアプリ埋め込みブロックで、テーマアプリ拡張機能として提供されます。

この流れはBuilt for Shopifyの要件にも反映されています。オンラインストアで使われるアプリはテーマアプリ拡張機能を使って要素を構築する必要があり、マーチャントのテーマファイルを追加・削除・編集してはならず、Built for Shopifyを申請するとAsset APIの使用が監査される、とされています。ただしこの要件には例外カテゴリーが設定されており、ページビルダー系、テーマファイル全体をバックアップ・復元するアプリ、SEOやコンテンツロック、開発者向けツールなどは別扱いです。「バッジがあれば必ずテーマを触らない」とまでは言えません。

つまり「Built for Shopifyバッジが付いているアプリは、テーマコードを汚さない可能性が高い」という読み方ができます。バッジを万能の品質保証として扱うのは危険ですが、この一点に関しては具体的な意味があります。

アプリ選定時に確認する項目

以上を踏まえると、アプリ掲載ページで確認すべき点が変わります。

• ストアフロントに表示するアプリか、管理画面だけで完結するアプリか
• 表示するなら、アプリブロック方式かアプリ埋め込み方式か、テーマコード編集を要求するか
• Vintageテーマを使っている場合、そのアプリが対応しているか
• テーマ移行を予定している場合、移行後に再設定が必要な範囲
• アンインストール時に追加の手順が必要と掲載ページに書かれていないか
• Built for Shopifyバッジの有無（テーマファイルを編集しない設計であることの手がかり）
• 複数マーケット運用の場合、マーケット別に出し分ける必要があるか

表示されないときの確認手順

1. テーマエディタを開き、サイドバーの「アプリ埋め込み」を確認する。対象アプリのトグルがオフなら、オンにして保存する
2. 位置を指定するタイプなら、「ブロックを追加」メニューに「アプリ」の項目があるか確認する。無ければそのセクションが非対応
3. 「商品」>「デフォルト商品」に「セクションを追加」ボタンがあるか確認し、テーマがOnline Store 2.0以降かを判定する
4. 直近でテーマを切り替えていないか確認する。切り替えていれば、有効化はリセットされている
5. それでも解決しない場合、アプリの掲載ページとドキュメントで、テーマコードの手動編集が必要かどうかを確認する

なお、ブロック選択メニューの検索バーは、インストール済みのアプリを検索するもので、App Store全体を検索するものではありません。ここで見つからないアプリは、そもそもインストールされていないか、そのページタイプに対応していません。

アプリが既にテーマにインストールされている場合、Sidekickに「商品ページにサイズチャートのアプリブロックを追加して」のように指示して、テーマエディタから追加・設定させることもできます。

まとめ

判断基準は3つに圧縮できます。

1. 表示されない原因の大半は、有効化されていないか、テーマが非対応か、テーマを切り替えたかのどれか。 アプリの不具合を疑う前に、テーマエディタのアプリ埋め込みとテーマアーキテクチャを確認します。
2. テーマ移行のたびに再設定が発生する。 テーマを新しくする計画があるなら、その作業コストを見込んでおきます。有効化が引き継がれないのは仕様です。
3. 連携方式はアンインストール時の負債を決める。 テーマアプリ拡張機能を使うアプリはテーマコードを編集しません。テーマコードへ直接注入するアプリは、消しても残ります。導入前に掲載ページの記載を確認するのが、最も安いコストで済む対策です。

そして、スクリプトタグに依存しているアプリには2027年3月1日という期限があります。長期的に使うアプリを選ぶなら、この移行が済んでいるかどうかも判断材料になります。