← inaro.devShopify学習ツール
15-02

アプリがテーマに入る仕組み

アプリブロックとアプリ埋め込みの仕組みを理解し、テーマをアプリ対応にできる

最終確認: 2026-09

解説

受託の現場でなぜ必要か: この回では、アプリがテーマに入る2つの経路を知り、テーマをアプリ対応にできるようになります。
受託では「レビューアプリを入れたのに商品ページに置けない」の原因を、テーマ側の@appの有無からすぐ突き止められます。

アプリブロックとは、セクションの中に置くアプリのUI

アプリブロックは、アプリが提供するUI(レビュー欄など)をセクションの中に置く仕組みです。
置けるのは、テーマ側のschemaに{"type": "@app"}があるセクションだけです。
これが無いと「このセクションにはアプリを追加できません」と表示されます。

アプリ埋め込み(app embed)とは、ページ全体に効く仕組み

アプリ埋め込みは、ページ全体に効くスクリプトや、<head>への挿入です。
テーマ設定の「アプリ埋め込み」でON/OFFします。
ポップアップ・チャット・計測系はこちらです。

テーマ側で準備することは

主要セクション(商品情報・カート・フッターなど)のschemaで、@appを許可します。
{% content_for 'blocks' %}を使うテーマブロック構成でも、同じように@appを受け入れます。
これを知っていれば、テーマを作る側でも直す側でも迷いません。

アプリを消したとき、テーマに何が残るか

theme app extensions(アプリ側の実装の名前)で作られたアプリは、テーマのファイルを書き換えません。
そのため、アプリを消せばテーマからも消えます(残骸が残りません)。
一方、Asset APIでテーマに直接コードを書き込む古いアプリは、アンインストール後もコードが残ります。
改修案件では、最初にこの残骸を棚卸しします。

ステップ1 / 2

ShopifyはShopify Inc.の商標です。本サイトは個人が制作した非公式の学習教材であり、同社の承認・提携・後援を受けていません。記載内容は2026-09時点のものです。料金・上限値・管理画面のラベルは変わるため、作業の前に公式ドキュメントで確認してください。