Shopify Liquid 顧客・ブログ・メタフィールドのオブジェクト

ログイン中の顧客の情報です。ログインしていなければ nil になります。

書き方

{% if customer %}

{% if customer %} でログイン判定ができます。タグで会員ランクを判定する使い方が定番です。

例

{% if customer %}
  {{ customer.first_name }}様
{% else %}
  <a href="{{ routes.account_login_url }}">ログイン</a>
{% endif %}

主要プロパティ（下に説明あり）
customer.first_name　customer.email　customer.tags　customer.orders_count　customer.total_spent　customer.orders　customer.accepts_marketing　customer.metafields

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

顧客の名（下の名前）です。

書き方

{{ customer.first_name }}

日本の顧客は姓を last_name に入れることが多いため、表示順に注意します。

例

{{ customer.last_name }} {{ customer.first_name }}様

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

顧客のメールアドレスです。

書き方

{{ customer.email }}

例

{{ customer.email }}

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

顧客タグの配列です。

書き方

{{ customer.tags }}

会員ランクごとに表示を切り替える判定に使います。

例

{% if customer.tags contains 'VIP' %}VIP限定クーポン{% endif %}

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

顧客の注文回数です。

書き方

{{ customer.orders_count }}

例

{% if customer.orders_count == 0 %}初回購入特典{% endif %}

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

顧客の累計購入金額です。

書き方

{{ customer.total_spent | money }}

例

{{ customer.total_spent | money }}

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

顧客の注文履歴の配列です。

書き方

{% for order in customer.orders %}

例

{% for order in customer.orders limit: 5 %}{{ order.name }}{% endfor %}

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

メールマガジンの受信を許可しているかどうかです。

書き方

{% if customer.accepts_marketing %}

例

{% unless customer.accepts_marketing %}メルマガ登録はこちら{% endunless %}

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

顧客のメタフィールドです。

書き方

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

例

{{ customer.metafields.custom.birthday.value | date: '%m月%d日' }}

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

住所の情報（顧客の住所・配送先など）です。

書き方

{{ address.city }}

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

例

{{ customer.default_address | format_address }}

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

B2B（企業向け販売）で顧客が所属する会社の情報です。

書き方

{{ company.name }}

例

{% if customer.b2b? %}{{ customer.current_company.name }}{% endif %}

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

会社の拠点の住所です。

書き方

{{ address.city }}

例

{{ customer.current_location.shipping_address.city }}

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

会社の拠点（支店など）の情報です。

書き方

{{ location.name }}

例

{{ customer.current_location.name }}

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

顧客が保存している支払い方法です。

書き方

{{ method.payment_instrument_type }}

例

{% for m in customer.payment_methods %}{{ m.payment_instrument_type }}{% endfor %}

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

顧客のストアクレジット（ストア内で使える残高）です。

書き方

{{ account.balance | money }}

例

{% if customer.store_credit_account %}{{ customer.store_credit_account.balance | money }}{% endif %}

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

form タグの中で使える、フォームの状態や入力値です。

書き方

{{ form.errors }}

送信後のエラーや成功（posted_successfully?）を判定できます。

例

{% form 'contact' %}{% if form.posted_successfully? %}送信しました{% endif %}{% endform %}

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

フォームのエラー内容の一覧です。

書き方

{{ form.errors.messages }}

例

{% for field in form.errors %}{{ form.errors.translated_fields[field] }}: {{ form.errors.messages[field] }}{% endfor %}

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

配送対象の国を <option> タグの一覧で出力します。

書き方

{{ country_option_tags }}

住所フォームの国選択に使います。

例

<select name="address[country]">{{ country_option_tags }}</select>

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

すべての国を <option> タグの一覧で出力します。

書き方

{{ all_country_option_tags }}

例

<select>{{ all_country_option_tags }}</select>

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

ブログ記事1件の情報です。

書き方

{{ article.title }}

記事ページで自動で使えます。

例

<h1>{{ article.title }}</h1>
{{ article.published_at | date: '%Y.%m.%d' }}

主要プロパティ（下に説明あり）
article.title　article.content　article.excerpt_or_content　article.published_at　article.tags　article.image　article.metafields

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

記事のタイトルです。

書き方

{{ article.title }}

例

{{ article.title }}

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

記事の本文（HTML）です。

書き方

{{ article.content }}

例

{{ article.content }}

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

抜粋があれば抜粋、なければ本文を返します。

書き方

{{ article.excerpt_or_content }}

記事一覧の紹介文に使います。

例

{{ article.excerpt_or_content | strip_html | truncate: 100 }}

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

記事の公開日時です。

書き方

{{ article.published_at | date: '%Y.%m.%d' }}

例

{{ article.published_at | time_tag: '%Y.%m.%d' }}

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

記事タグの配列です。

書き方

{{ article.tags }}

例

{% for tag in article.tags %}<a href="{{ blog.url }}/tagged/{{ tag | handleize }}">{{ tag }}</a>{% endfor %}

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

記事のアイキャッチ画像です。

書き方

{{ article.image }}

例

{% if article.image %}{{ article.image | image_url: width: 800 | image_tag }}{% endif %}

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

記事のメタフィールドです。

書き方

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

例

{{ article.metafields.custom.parent_article.value }}

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

ハンドルを指定して任意の記事を取り出せるオブジェクトです。

書き方

{{ articles['blog/article'] }}

例

{% assign a = articles['news/2026-sale'] %}{{ a.title }}

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

ブログ（記事のまとまり）の情報です。

書き方

{{ blog.title }}

例

{% for article in blog.articles limit: 5 %}{{ article.title }}{% endfor %}

主要プロパティ（下に説明あり）
blog.articles

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

ブログの記事の配列です。

書き方

{% for article in blog.articles %}

例

{% for article in blog.articles limit: 3 %}{{ article.title }}{% endfor %}

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

ストアのすべてのブログです。ハンドルで1つを取り出せます。

書き方

{{ blogs['handle'] }}

例

{% for a in blogs.news.articles limit: 3 %}{{ a.title }}{% endfor %}

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

ブログ記事へのコメントの情報です。

書き方

{{ comment.content }}

例

{% for c in article.comments %}{{ c.author }}: {{ c.content }}{% endfor %}

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

ブログ記事を書いたスタッフの情報です。

書き方

{{ article.author }}

例

{{ article.user.first_name }}

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

固定ページ（会社概要など）の情報です。

書き方

{{ page.title }}

例

<h1>{{ page.title }}</h1>{{ page.content }}

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

ハンドルを指定して任意の固定ページを取り出せるオブジェクトです。

書き方

{{ pages['handle'] }}

例

{{ pages['shipping'].content }}

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

返品・プライバシーなど、ストアのポリシーの情報です。

書き方

{{ policy.title }}

例

{% for p in shop.policies %}<a href="{{ p.url }}">{{ p.title }}</a>{% endfor %}

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

管理画面で作ったすべてのメニューです。

書き方

{{ linklists['handle'] }}

例

{% for link in linklists['footer'].links %}{{ link.title }}{% endfor %}

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

メニュー1つ分の情報です。

書き方

{{ linklist.links }}

テーマ設定のメニュー選択（link_list 型）からも取り出せます。

例

{% for link in section.settings.menu.links %}<a href="{{ link.url }}">{{ link.title }}</a>{% endfor %}

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

メニュー内のリンク1つ分の情報です。

書き方

{{ link.title }}

current（今のページか）や子メニュー（links）を持ちます。

例

<a href="{{ link.url }}"{% if link.current %} aria-current="page"{% endif %}>{{ link.title }}</a>

主要プロパティ（下に説明あり）
link.links　link.current

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

子メニュー（下の階層のリンク）の配列です。

書き方

{% for child in link.links %}

例

{% for child in link.links %}{{ child.title }}{% endfor %}

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

表示中のページへのリンクかどうかです。

書き方

{% if link.current %}

例

{% if link.current %}class="is-current"{% endif %}

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

メタフィールド（商品などに追加した独自の項目）1つ分の情報です。

書き方

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

値は .value で取り出します。型（type）によって返る値が変わり、リスト型は配列になります。

例

{% assign spec = product.metafields.custom.material %}
{% if spec != blank %}素材: {{ spec.value }}{% endif %}

出力

素材: 綿100%

主要プロパティ（下に説明あり）
metafield.value　metafield.type　metafield.list?

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

メタフィールドの値です。

書き方

{{ metafield.value }}

型に応じて文字列・数値・オブジェクト・配列などで返ります。

例

{{ product.metafields.custom.material.value }}

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

メタフィールドの型（single_line_text_field など）です。

書き方

{{ metafield.type }}

例

{{ product.metafields.custom.material.type }}

出力

single_line_text_field

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

リスト型のメタフィールドかどうかです。

書き方

{% if metafield.list? %}

例

{% if product.metafields.custom.files.list? %}複数{% endif %}

公式ドキュメント　｜　関連TIPS：Shopifyでリスト型のメタフィールドの配列数は.sizeではなく、.countで取得する ／ ShopifyのLiquidでメタフィールド「ファイル(リスト)」の登録数を取得する方法　｜　目次へ戻る ↑

オブジェクトに付いたメタフィールドを、名前空間（custom など）ごとにまとめたものです。

書き方

{{ product.metafields.custom }}

例

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

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

1つの名前空間に属するメタフィールドの集まりです。

書き方

{{ product.metafields.custom.キー }}

例

{{ product.metafields.custom.size_guide.value }}

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

メタオブジェクト（自分で定義したデータの型）1件分の情報です。

書き方

{{ metaobject.フィールド.value }}

メタフィールドの参照から、または metaobjects から取り出します。

例

{% assign faq = metaobjects.faq['shipping'] %}
{{ faq.question.value }}

公式ドキュメント　｜　関連TIPS：ShopifyのメタオブジェクトのLiquidコード上での参照方法 ／ Shopifyのコンテンツタイプ「メタオブジェクト」のメタフィールド値をLiquidのコードから呼び出す方法 ／ ShopifyのLiquidコードでメタオブジェクトを直接参照する方法　｜　目次へ戻る ↑

ストアのすべてのメタオブジェクトです。タイプとハンドルで取り出します。

書き方

{{ metaobjects.タイプ['handle'] }}

shop.metaobjects は非推奨になり、こちらに置き換わりました。

例

{% for item in metaobjects.faq.values %}{{ item.question.value }}{% endfor %}

公式ドキュメント　｜　関連TIPS：ShopifyのメタオブジェクトのLiquidコード上での参照方法 ／ Shopifyのコンテンツタイプ「メタオブジェクト」のメタフィールド値をLiquidのコードから呼び出す方法 ／ ShopifyのLiquidコードでメタオブジェクトを直接参照する方法　｜　目次へ戻る ↑

メタオブジェクトのタイプ（定義）と、その中身の一覧です。

書き方

{{ metaobjects.タイプ.values }}

values のループは1回50件までの制限があります。

例

{{ metaobjects.faq.values_count }}件

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

メタオブジェクトのハンドルやIDなど、システムが持つ情報です。

書き方

{{ metaobject.system.handle }}

例

{{ faq.system.handle }}

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