Shopify Liquid グローバルオブジェクト｜shop・request・routes・section・settings

ストアの情報（名前・URL・通貨・ポリシーなど）です。

書き方

{{ shop.name }}

どのページでも使えます。

例

© {{ 'now' | date: '%Y' }} {{ shop.name }}

出力

© 2026 STORE DOJO

主要プロパティ（下に説明あり）
shop.name　shop.url　shop.metafields　shop.metaobjects　shop.locale　shop.taxes_included

公式ドキュメント　｜　目次へ戻る ↑

ストア名です。

書き方

{{ shop.name }}

例

{{ shop.name }}

出力

STORE DOJO

公式ドキュメント　｜　目次へ戻る ↑

ストアのトップページの URL です。

書き方

{{ shop.url }}

例

{{ shop.url }}

出力

https://store-dojo.com

公式ドキュメント　｜　目次へ戻る ↑

ストア全体のメタフィールドです。

書き方

{{ shop.metafields.custom.キー.value }}

サイト全体で使う告知文などを1か所で管理するときに使えます。

例

{{ shop.metafields.custom.notice.value }}

公式ドキュメント　｜　目次へ戻る ↑

メタオブジェクトを取り出す古いプロパティです。

書き方

{{ shop.metaobjects }}

非推奨です。metaobjects を直接使います。

非推奨　代わりに：metaobjects

例

{{ metaobjects.faq['shipping'].question.value }}

公式ドキュメント　｜　目次へ戻る ↑

言語を返す古いプロパティです。

書き方

{{ shop.locale }}

非推奨です。request.locale を使います。

非推奨　代わりに：request.locale

例

{{ request.locale.iso_code }}

出力

ja

公式ドキュメント　｜　目次へ戻る ↑

価格が税込みかどうかを返す古いプロパティです。

書き方

{% if shop.taxes_included %}

非推奨です。国によって変わるため cart.taxes_included を使います。

非推奨　代わりに：cart。cart.taxes_included を使う

例

{% if cart.taxes_included %}税込{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

ストアで公開している言語の情報です。

書き方

{{ locale.iso_code }}

例

{% for l in shop.published_locales %}{{ l.endonym_name }}{% endfor %}

出力

日本語 English

公式ドキュメント　｜　目次へ戻る ↑

管理画面の「ブランド」で設定したロゴ・色・スローガンです。

書き方

{{ shop.brand.logo }}

例

{{ shop.brand.slogan }}

公式ドキュメント　｜　目次へ戻る ↑

ブランドの色1つ分の情報です。

書き方

{{ shop.brand.colors.primary }}

例

{{ shop.brand.colors.primary.first.background }}

公式ドキュメント　｜　目次へ戻る ↑

ブランドの色のグループ（主色・補助色）です。

書き方

{{ shop.brand.colors }}

例

{{ shop.brand.colors.secondary.first.background }}

公式ドキュメント　｜　目次へ戻る ↑

テーマ設定の色の値です。成分（red、alpha など）も取り出せます。

書き方

{{ settings.accent_color }}

例

{{ settings.accent_color.red }}

出力

122

公式ドキュメント　｜　目次へ戻る ↑

テーマの配色（カラースキーム）1つ分の設定です。

書き方

{{ section.settings.color_scheme.settings.background }}

例

<div class="color-{{ section.settings.color_scheme.id }}">...</div>

公式ドキュメント　｜　目次へ戻る ↑

テーマで定義されたすべての配色です。

書き方

{{ settings.color_schemes }}

例

{% for scheme in settings.color_schemes %}.color-{{ scheme.id }} { background: {{ scheme.settings.background }}; }{% endfor %}

公式ドキュメント　｜　目次へ戻る ↑

テーマ設定で選んだフォントの情報です。

書き方

{{ settings.type_body_font.family }}

例

font-family: {{ settings.type_body_font.family }}, {{ settings.type_body_font.fallback_families }};

公式ドキュメント　｜　目次へ戻る ↑

テーマ全体の設定（テーマ設定画面の値）です。

書き方

{{ settings.キー }}

config/settings_schema.json で定義した項目が入ります。

例

{% if settings.show_badge %}<span class="badge">SALE</span>{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

セクションファイルの中で使える、そのセクションの設定と情報です。

書き方

{{ section.settings.キー }}

section.id は同じセクションを複数置いたときの区別に使えます。

例

<div id="banner-{{ section.id }}">{{ section.settings.heading }}</div>

主要プロパティ（下に説明あり）
section.id　section.settings　section.blocks

公式ドキュメント　｜　目次へ戻る ↑

セクションの固有の ID です。

書き方

{{ section.id }}

同じセクションを2つ置いても CSS や JS が混ざらないように、クラス名や id に使います。

例

<div id="section-{{ section.id }}">...</div>

公式ドキュメント　｜　目次へ戻る ↑

セクションの設定値です。

書き方

{{ section.settings.キー }}

例

{{ section.settings.heading }}

公式ドキュメント　｜　目次へ戻る ↑

セクション内のブロックの配列です。

書き方

{% for block in section.blocks %}

例

{% for block in section.blocks %}{% case block.type %}{% when 'text' %}{{ block.settings.text }}{% endcase %}{% endfor %}

公式ドキュメント　｜　目次へ戻る ↑

ブロックの設定と情報です。

書き方

{{ block.settings.キー }}

ブロックの外側の要素に {{ block.shopify_attributes }} を付けると、テーマエディタでクリックして選べるようになります。

例

{% for block in section.blocks %}
  <div {{ block.shopify_attributes }}>{{ block.settings.text }}</div>
{% endfor %}

主要プロパティ（下に説明あり）
block.shopify_attributes　block.settings

公式ドキュメント　｜　目次へ戻る ↑

テーマエディタでブロックを選べるようにするための属性です。

書き方

{{ block.shopify_attributes }}

ブロックの一番外側の要素に付けます。

例

<div {{ block.shopify_attributes }}>...</div>

公式ドキュメント　｜　目次へ戻る ↑

ブロックの設定値です。

書き方

{{ block.settings.キー }}

例

{{ block.settings.text }}

公式ドキュメント　｜　目次へ戻る ↑

テーマブロックから、いちばん近い位置にある商品やコレクションなどを取り出すオブジェクトです。

書き方

{{ closest.product }}

商品カードの中に置いたブロックで、その商品を参照するときに使います（Horizon 世代のテーマ）。

例

{% assign p = closest.product %}
{{ p.title }}

公式ドキュメント　｜　関連TIPS：【Horizon】テーマ「Horizon」でストアのメニューから自動でパンくずリストを生成するテーマブロック　｜　目次へ戻る ↑

今のスコープ（変数が見える範囲）から値を取り出すオブジェクトです。

書き方

{{ self.キー }}

例

{{ self.title }}

公式ドキュメント　｜　目次へ戻る ↑

表示中のテンプレートの種類（product、collection など）です。

書き方

{{ template.name }}

ページの種類ごとに表示を変える条件に使います。

例

<body class="template-{{ template.name }}{% if template.suffix %} {{ template.suffix }}{% endif %}">...</body>

出力

<body class="template-product">...</body>

主要プロパティ（下に説明あり）
template.name　template.suffix

公式ドキュメント　｜　目次へ戻る ↑

テンプレートの種類名です。

書き方

{{ template.name }}

例

{% if template.name == 'index' %}トップページ{% endif %}

出力

index

公式ドキュメント　｜　目次へ戻る ↑

代替テンプレートの名前（product.〇〇 の〇〇）です。

書き方

{{ template.suffix }}

例

{{ template.suffix }}

公式ドキュメント　｜　目次へ戻る ↑

テーマの情報を表す古いオブジェクトです。

書き方

{{ theme.name }}

非推奨です。値が変わる可能性があり、条件分岐に使うと予期せず動作が変わるためです。

非推奨　代わりに：テーマエディタへのリンクは /admin/themes/current/editor を使う

例

{% # 使わない %}

公式ドキュメント　｜　目次へ戻る ↑

表示中のページの URL・言語・表示モードなど、リクエスト（閲覧要求）の情報です。

書き方

{{ request.path }}

request.design_mode でテーマエディタ表示中かを判定できます。

例

{% if request.page_type == 'index' %}トップページ{% endif %}
{{ request.path }}

主要プロパティ（下に説明あり）
request.path　request.page_type　request.design_mode　request.locale　request.origin

公式ドキュメント　｜　関連TIPS：ShopifyのLiquidコードでURLパラメーターを取得する方法 ／ Shopifyで現在表示中のページURL（pathname）をLiquidで取得する方法　｜　目次へ戻る ↑

表示中ページのパス（ドメインより後ろの部分）です。

書き方

{{ request.path }}

例

{% if request.path contains '/collections/sale' %}セール中{% endif %}

出力

/collections/sale

公式ドキュメント　｜　関連TIPS：ShopifyのLiquidコードでURLパラメーターを取得する方法 ／ Shopifyで現在表示中のページURL（pathname）をLiquidで取得する方法　｜　目次へ戻る ↑

表示中ページの種類です。

書き方

{{ request.page_type }}

例

{% if request.page_type == 'product' %}商品ページ{% endif %}

出力

product

公式ドキュメント　｜　目次へ戻る ↑

テーマエディタで表示中かどうかです。

書き方

{% if request.design_mode %}

エディタ上だけ説明文を出す、といった使い方ができます。

例

{% if request.design_mode %}<p>ここに画像を設定してください</p>{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

表示中の言語です。

書き方

{{ request.locale.iso_code }}

例

<html lang="{{ request.locale.iso_code }}">...</html>

出力

ja

公式ドキュメント　｜　目次へ戻る ↑

プロトコル付きのドメイン（https://〜）です。

書き方

{{ request.origin }}

例

{{ request.origin }}{{ product.url }}

出力

https://store-dojo.com/products/organic-tee

公式ドキュメント　｜　目次へ戻る ↑

カート・アカウント・検索など、ストアの標準ページの URL です。

書き方

{{ routes.cart_url }}

多言語のURLにも自動で対応するため、/cart などを直接書くよりも安全です。

例

<a href="{{ routes.cart_url }}">カート</a>

出力

<a href="/cart">カート</a>

主要プロパティ（下に説明あり）
routes.root_url　routes.account_login_url　routes.search_url

公式ドキュメント　｜　目次へ戻る ↑

トップページの URL です。

書き方

{{ routes.root_url }}

多言語ストアでは /en などの言語別パスになります。

例

<a href="{{ routes.root_url }}">ホーム</a>

出力

/

公式ドキュメント　｜　目次へ戻る ↑

ログインページの URL です。

書き方

{{ routes.account_login_url }}

例

<a href="{{ routes.account_login_url }}">ログイン</a>

公式ドキュメント　｜　目次へ戻る ↑

検索ページの URL です。

書き方

{{ routes.search_url }}

例

<form action="{{ routes.search_url }}"><input name="q"></form>

出力

/search

公式ドキュメント　｜　目次へ戻る ↑

訪問者が選んでいる国・言語と、選べる国・言語の一覧です。

書き方

{{ localization.country.name }}

国と言語の切り替えメニューを作るときに使います。

例

{{ localization.language.endonym_name }} / {{ localization.country.currency.iso_code }}

出力

日本語 / JPY

主要プロパティ（下に説明あり）
localization.available_countries　localization.available_languages

公式ドキュメント　｜　目次へ戻る ↑

選べる国の配列です。

書き方

{% for c in localization.available_countries %}

例

{% for c in localization.available_countries %}{{ c.name }}{% endfor %}

公式ドキュメント　｜　目次へ戻る ↑

選べる言語の配列です。

書き方

{% for l in localization.available_languages %}

例

{% for l in localization.available_languages %}{{ l.endonym_name }}{% endfor %}

公式ドキュメント　｜　目次へ戻る ↑

国の情報（名前・通貨・ISOコード）です。

書き方

{{ country.name }}

例

{{ localization.country.iso_code }}

出力

JP

公式ドキュメント　｜　目次へ戻る ↑

通貨の情報（コード・記号）です。

書き方

{{ currency.iso_code }}

例

{{ cart.currency.symbol }}

出力

¥

公式ドキュメント　｜　目次へ戻る ↑

Shopify Markets で設定した販売地域（マーケット）の情報です。

書き方

{{ localization.market.handle }}

例

{% if localization.market.handle == 'jp' %}国内向け{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

Shopify やアプリが必要とするスクリプトなどを <head> 内に出力します。

書き方

{{ content_for_header }}

layout ファイルの <head> に必ず置きます。中身を加工してはいけません。

例

<head>
  {{ content_for_header }}
</head>

公式ドキュメント　｜　目次へ戻る ↑

各テンプレートの中身を、レイアウトの中に差し込む場所です。

書き方

{{ content_for_layout }}

layout ファイルに必ず置きます。

例

<main>{{ content_for_layout }}</main>

公式ドキュメント　｜　目次へ戻る ↑

旧式の Liquid 版トップページテンプレートで、セクションを並べる場所です。

書き方

{{ content_for_index }}

JSON テンプレートでは使えません。Online Store 2.0 のテーマでは使いません。

例

{{ content_for_index }}

公式ドキュメント　｜　目次へ戻る ↑

そのページの正規 URL（検索エンジンに伝える代表のURL）です。

書き方

{{ canonical_url }}

例

<link rel="canonical" href="{{ canonical_url }}">

公式ドキュメント　｜　目次へ戻る ↑

ページのタイトル（<title> 用）です。

書き方

{{ page_title }}

例

<title>{{ page_title }}{% unless page_title contains shop.name %} | {{ shop.name }}{% endunless %}</title>

公式ドキュメント　｜　目次へ戻る ↑

ページの説明文（meta description 用）です。

書き方

{{ page_description }}

例

{% if page_description %}<meta name="description" content="{{ page_description | escape }}">{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

ページの代表画像（SNS 共有用など）です。

書き方

{{ page_image }}

例

{% if page_image %}<meta property="og:image" content="https:{{ page_image | image_url: width: 1200 }}">{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

表示中のページ（商品・コレクションなど）のハンドルです。

書き方

{{ handle }}

例

{% if handle == 'about' %}会社概要ページ{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

「Powered by Shopify」のリンクを出力します。

書き方

{{ powered_by_link }}

例

{{ powered_by_link }}

公式ドキュメント　｜　目次へ戻る ↑

for ループの中で使える、何回目か・最初か最後かなどの情報です。

書き方

{{ forloop.index }}

index は1から、index0 は0から数えます。

例

{% for p in collection.products limit: 3 %}
  <p{% if forloop.first %} class="top"{% endif %}>{{ forloop.index }}位 {{ p.title }}</p>
{% endfor %}

出力

1位 ...

主要プロパティ（下に説明あり）
forloop.index　forloop.index0　forloop.first　forloop.last　forloop.length

公式ドキュメント　｜　目次へ戻る ↑

1から数えた、今が何回目かです。

書き方

{{ forloop.index }}

例

{{ forloop.index }}

出力

1

公式ドキュメント　｜　目次へ戻る ↑

0から数えた、今が何回目かです。

書き方

{{ forloop.index0 }}

例

{{ forloop.index0 }}

出力

0

公式ドキュメント　｜　目次へ戻る ↑

最初の回かどうかです。

書き方

{% if forloop.first %}

例

{% if forloop.first %}<span>おすすめ</span>{% endif %}

公式ドキュメント　｜　目次へ戻る ↑

最後の回かどうかです。

書き方

{% if forloop.last %}

区切り記号を最後だけ付けない処理によく使います。

例

{{ tag }}{% unless forloop.last %}、{% endunless %}

公式ドキュメント　｜　目次へ戻る ↑

ループの総回数です。

書き方

{{ forloop.length }}

例

{{ forloop.index }}/{{ forloop.length }}

出力

1/4

公式ドキュメント　｜　目次へ戻る ↑

tablerow ループの中で使える、行・列の位置などの情報です。

書き方

{{ tablerowloop.col }}

チートシートでは tablerow と書かれていますが、公式では tablerowloop オブジェクトです。

例

{% tablerow p in collection.products cols: 3 %}{{ tablerowloop.col }}{% endtablerow %}

公式ドキュメント　｜　目次へ戻る ↑

robots.txt.liquid で使う、標準の robots.txt のルール一式です。

書き方

{{ robots.default_groups }}

既定のルールを残したまま、一部だけ追加・除外するときに使います。

例

{% for group in robots.default_groups %}{{ group.user_agent }}{% for rule in group.rules %}{{ rule }}{% endfor %}{% endfor %}

公式ドキュメント　｜　関連TIPS：Shopifyの「robots.txt.liquid」を編集して特定のDisallowルールを除外する方法　｜　目次へ戻る ↑

robots.txt のルールのまとまり（対象のクローラーごと）です。

書き方

{{ group.user_agent }}

例

{{ group.user_agent }}

出力

User-agent: *

公式ドキュメント　｜　目次へ戻る ↑

robots.txt の1行分のルール（Disallow など）です。

書き方

{{ rule.directive }}: {{ rule.value }}

例

{% for rule in group.rules %}{% unless rule.value == '/search' %}{{ rule }}{% endunless %}{% endfor %}

公式ドキュメント　｜　目次へ戻る ↑

robots.txt に書くサイトマップの指定です。

書き方

{{ group.sitemap }}

例

{{ group.sitemap }}

出力

Sitemap: https://store-dojo.com/sitemap.xml

公式ドキュメント　｜　目次へ戻る ↑

robots.txt の User-agent 行です。

書き方

{{ group.user_agent }}

例

{{ group.user_agent }}

公式ドキュメント　｜　目次へ戻る ↑

アプリ拡張機能の中で使える、そのアプリの情報です。

書き方

{{ app.metafields }}

テーマのコードではなく、アプリのテーマ拡張で使います。

例

{{ app.metafields.settings.message.value }}

公式ドキュメント　｜　目次へ戻る ↑