リファレンス/オブジェクト
137 件のスニペット・リファレンス
content_for_header オブジェクト
Shopify が必要とするスクリプト（分析・チェックアウト・言語設定など）をすべて動的に出力するオブジェクト。theme.liquid の <head> タグ内に埋め込む必須要素。
metaobjects オブジェクト
ストア全体のメタオブジェクト定義にアクセスするグローバルオブジェクト。個別のメタオブジェクトはタイプとハンドルで参照でき、メタオブジェクト定義のエントリをループで反復処理できる。
additional_checkout_buttons オブジェクト
PayPal Express Checkout など、オフサイト決済に対応した外部決済プロバイダーがストアに設定されているかを真偽値で返す。`content_for_additional_checkout_buttons` と組み合わせて、該当するチェックアウトボタンを条件付きで表示する。
canonical_url オブジェクト
現在のページの正規 URL を取得するオブジェクト。Google などの検索エンジンに対してどのページ版が正規であるかを指定するために使用する。
content_for_index オブジェクト
ホームページに表示するセクションの内容を動的に返すオブジェクト。Liquid インデックステンプレートで必ず使用する。
content_for_additional_checkout_buttons オブジェクト
PayPal、Apple Pay、Google Pay など複数の決済プロバイダが有効になっているとき、その決済ボタンを HTML として出力するオブジェクト。`additional_checkout_buttons` で有無を判定したうえで、このオブジェクトで実際のボタンを表示する。
content_for_layout オブジェクト
現在のテンプレートに応じた動的コンテンツをレイアウトファイルに埋め込む。theme.liquid の `<body>` 内で使用し、ページごとに異なる HTML を自動的に挿入する。
handle オブジェクト
現在表示しているテンプレートに関連するリソース（商品・コレクション・記事など）のハンドルを返す。記事、ブログ、コレクション、ページ、商品テンプレートでのみ利用可能で、その他のテンプレートでは nil を返す。
page_image オブジェクト
現在のページ（商品、コレクション、ブログ記事）のフィーチャー画像を表すオブジェクト。フィーチャー画像がない場合は、管理画面で設定した SNS シェア用画像を参照する。
app オブジェクト
テーマアプリ拡張機能がアプリ固有の情報にアクセスするためのオブジェクト。アプリが所有するメタフィールドを参照する。
current_tags オブジェクト
ブログ記事または商品に適用されているタグの一覧を取得するオブジェクト。ブログページやコレクションページでタグによるフィルタリングに使用する。
color_scheme_group オブジェクト
テーマ設定の color_scheme_group セッティングで定義したカラースキームグループを参照するオブジェクト。色設定をセッティングから取得して CSS 変数として出力する。
powered_by_link オブジェクト
ストアのロケール（言語・地域）に応じて、Shopify.com へのローカライズされたリンク HTML を自動生成するオブジェクト。フッターなどで「Powered by Shopify」表記が必要なときに使用する。
settings オブジェクト
テーマの settings_schema.json で定義されたすべての設定値にアクセスするオブジェクト。管理画面のカスタマイズ画面で設定した値を Liquid テンプレート内で参照する。
page_title オブジェクト
現在のページのタイトルを取得するオブジェクト。検索エンジンのリスティングやソーシャルメディアプレビューに使用するページタイトルを指定する。
page_description オブジェクト
現在のページのメタディスクリプションを取得するオブジェクト。検索エンジンのスニペットや SNS 共有時のプレビューテキストとして使用される。
all_country_option_tags オブジェクト
全世界の国・地域ごとに `<option>` タグを生成するオブジェクト。各オプションの `data-provinces` 属性に、その国・地域の下位区分（都道府県など）を JSON 配列形式で埋め込む。
all_products オブジェクト
ストア内のすべての商品にアクセスするグローバルオブジェクト。商品ハンドルを指定して特定の商品データを取得できる。
articles オブジェクト
ストア内のすべてのブログ記事にアクセスするグローバルオブジェクト。ハンドル（ブログ名/記事スラッグ）で特定の記事を取得できる。
blogs オブジェクト
ストア内のすべてのブログにアクセスするグローバルオブジェクト。ブログハンドルを指定することで、該当ブログの記事一覧を取得できる。
country_option_tags オブジェクト
ストアの配送設定に含まれる国・地域ごとに `<option>` タグを生成するオブジェクト。各オプションには `data-provinces` 属性で都道府県などの下位地域が JSON 配列として格納される。
current_page オブジェクト
ページネーション対応ページの現在のページ番号を取得するオブジェクト。非ページネーション環境では常に 1 を返す。
images オブジェクト
ストアにアップロードされたすべての画像にアクセスするグローバルオブジェクト。ファイル名をキーとして画像を取得し、image_url や image_tag フィルターで処理できる。
linklists オブジェクト
ストア管理画面で作成したメニュー（リンクリスト）全体にアクセスするグローバルオブジェクト。メニューのハンドルを指定して、そのリンク一覧を取得できる。
robots オブジェクト
robots.txt.liquid テンプレートで使う、検索エンジンのクローラーに対する指示ルールをまとめたオブジェクト。デフォルトのルールグループを取得する。
image_presentation オブジェクト
画像の表示設定を管理するオブジェクト。焦点位置（フォーカルポイント）などの表示パラメータを保持する。
parent_relationship オブジェクト
ネストされたカート行アイテムの親行アイテムに関する情報を持つオブジェクト。バンドル商品や親子関係のある複数行アイテムの親を参照できる。
brand_color オブジェクト
Shopify 管理画面の「ブランドアセット」で定義されたストアのブランドカラーにアクセスするオブジェクト。プライマリ・セカンダリ色グループごとに、背景色と前景色（対比用）を取得できる。
store_credit_account オブジェクト
顧客が保有するストアクレジット（店舗内ポイント・ギフトカード的な残高管理機能）のアカウント情報を扱うオブジェクト。残高を顧客の地域通貨で取得できる。
collections オブジェクト
ストア内のすべてのコレクションを配列で取得するグローバルオブジェクト。コレクションのループやハンドル指定でのアクセスが可能。
pages オブジェクト
ストア内のすべてのページにアクセスするオブジェクト。ページハンドルで特定ページを直接参照するか、ループで複数ページを一括処理できる。
scripts オブジェクト
ストアで現在有効になっているスクリプトにアクセスするオブジェクト。現在 Liquid で利用できるのは `cart_calculate_line_items`（カート計算スクリプト）のみ。
money オブジェクト
顧客の現地通貨で表示される金額オブジェクト。メタフィールドやストアクレジット残高など、金額データを扱うときに使用する。
customer_payment_method オブジェクト
顧客がアカウントに保存した支払い方法（クレジットカードなど）を表すオブジェクト。支払い方法の種類と識別子にアクセスできる。
instructions オブジェクト
カート内の入れ子構造の行アイテムに対する操作制限を定義するオブジェクト。該当行の削除可否と数量更新可否をブール値で提供する。
pending_payment_instruction_input オブジェクト
銀行振込やMultibancoなど決済方法固有のオフライン決済手順を格納するオブジェクト。ヘッダーと対応する値をペアで保持し、顧客がトランザクション完了に必要な情報（振込先、参照番号など）を取得できる。
quantity_price_break オブジェクト
バリアントの数量割引（段階的価格）情報を格納するオブジェクト。最小購入数と対応する単価を保持する。
rule オブジェクト
robots.txt ファイル内のクローラーアクセス制御ルールを表すオブジェクト。directive（Allow または Disallow）と value（URL パス）で構成される。
script オブジェクト
Shopify Scripts の ID と名前を参照するオブジェクト。スクリプトエディタで作成したスクリプトの情報にアクセスする。
selling_plan_allocation_price_adjustment オブジェクト
定期販売プランの価格調整内容を表すオブジェクト。selling_plan_allocation 配下の price_adjustments 配列に含まれ、調整後の実際の価格と配列内での位置を保持する。
sitemap オブジェクト
robots.txt ファイル内で、サイトマップの位置情報を管理するオブジェクト。directive と value の2つのプロパティを持ち、Google のクローラーにサイトマップの存在と URL を告知する。
user_agent オブジェクト
robots.txt ファイル内のユーザーエージェント指定を表すオブジェクト。各クローラーグループの User-agent ディレクティブと値を格納する。
discount_allocation オブジェクト
商品または配送方法に適用されたディスカウントの詳細情報。ディスカウント金額と適用元のディスカウント施策を保持する。
sort_option オブジェクト
コレクションページと検索結果ページで利用可能なソートオプション。顧客向けの表示名とクエリ用の値を持つ。
swatch オブジェクト
商品オプションやフィルター値のカラーバリエーション・画像を表示するためのオブジェクト。色見本や商品バリエーション画像を Liquid テンプレート内で参照する。
color_scheme オブジェクト
テーマ設定で定義したカラースキームにアクセスするオブジェクト。カラースキームの ID とそれに紐付く設定値（色・テキストなど）を取得できる。
filter_value_display オブジェクト
フィルター値の視覚的な表現（色見本または画像）を定義するオブジェクト。フィルター値に紐付く色リストまたは画像を type プロパティで判別して value に格納する。
metaobject_definition オブジェクト
ストアに定義されたメタオブジェクトの構造を表すオブジェクト。merchant-defined なフィールド定義の集合で構成され、対応する metaobject の値を保持する。
metaobject オブジェクト
メタオブジェクト定義に基づいて作成された個別のメタオブジェクトエントリ。メタオブジェクト定義で定義されたフィールドの値セットを保有する。
focal_point オブジェクト
画像のフォーカルポイント（焦点位置）を管理するオブジェクト。テーマがトリミング時にもフォーカルポイントが画面内に収まるよう指定できる。
remote_details オブジェクト
外部ストアから取得した商品など、リモートソースから供給されたオブジェクトの出所情報を提供する。出所の種類と提供元ストアの詳細にアクセスできる。
selling_plan_checkout_charge オブジェクト
サブスクリプション販売プラン（定期購入）でチェックアウト時に顧客が支払う金額に関する情報を持つオブジェクト。金額が定価の割合か固定額かを value_type で区別し、value で具体値を取得できる。
group オブジェクト
robots.txt ファイル内のユーザーエージェント別ルールグループを表すオブジェクト。クローラーの許可・禁止設定とサイトマップ情報をまとめて管理する。
model_source オブジェクト
3D モデルのソースファイル情報を保持するオブジェクト。ファイル形式、MIME タイプ、CDN 上の URL を参照できる。
rating オブジェクト
rating 型メタフィールドの値を扱うオブジェクト。評価値と評価スケールの最小値・最大値にアクセスできる。
selling_plan_option オブジェクト
定期購入プラン（サブスクリプション）で選択されたオプション値を表す。プラングループのオプション名・位置・値を取得する。
form_errors オブジェクト
form タグで作成したフォームのバリデーションエラーを格納するオブジェクト。エラーカテゴリ文字列と、対応するエラーメッセージ・フィールド名を取得できる。
recipient オブジェクト
ギフトカードの受取人情報を持つオブジェクト。受取人のニックネーム、メールアドレス、フルネームにアクセスできる。
market オブジェクト
Shopify Markets で設定されたマーケット（販売地域グループ）の情報を取得するオブジェクト。マーケット ID、ハンドル、メタフィールドを参照できる。
predictive_search オブジェクト
検索API経由で取得した予測検索（オートコンプリート）の結果情報を返すオブジェクト。検索クエリに対して商品、コレクション、記事、ページなどから該当する結果を取得できる。
quantity_rule オブジェクト
バリアント単位で設定された注文数量ルール（最小・最大・増分）を参照するオブジェクト。B2B カタログで数量制限を施す際に利用する。
recommendations オブジェクト
商品ページで Shopify の商品推奨 API を使用したときに、販売データと商品情報に基づいて関連商品を取得するオブジェクト。本番環境でのみ機能し、推奨商品のリストと件数を返す。
measurement オブジェクト
メタフィールドの measurement 型から取得した、寸法・体積・重量の単位付き数値を扱うオブジェクト。type、value、unit の3つのプロパティで構成される。
theme オブジェクト
現在のテーマに関する情報（ID、名前、公開状態）にアクセスするオブジェクト。廃止予定のため新規実装は推奨されない。
block オブジェクト
セクション内の再利用可能なコンテンツモジュール（ブロック）の ID、タイプ、設定にアクセスするオブジェクト。セクションスキーマで定義した最大50個のブロックにそれぞれ対応する。
linklist オブジェクト
ストアのメニュー（リンクリスト）を表現するオブジェクト。メニュー内のリンク、タイトル、階層構造にアクセスできる。
product_option オブジェクト
商品のオプション（色、サイズなど）を表すオブジェクト。オプション名、位置、選択可能な値、現在選択されている値にアクセスできる。
predictive_search_resources オブジェクト
検索候補機能で返された記事、コレクション、ページ、商品を種類ごとに整理した配列を集めたオブジェクト。各リソースタイプの検索結果を参照する際に使う。
selling_plan_group_option オブジェクト
定期配送プラングループ内のオプション情報を表すオブジェクト。オプション名、位置、利用可能な値、現在選択されている値にアクセスできる。
store_availability オブジェクト
バリアント在庫の店舗別情報（在庫可否・ピックアップ対応・受取準備時間）を取得するオブジェクト。店舗受取機能が有効な場所のデータのみ存在する。
transaction_payment_details オブジェクト
取引に使われた支払方法の情報を保持するオブジェクト。クレジットカードまたはギフトカードの詳細を参照する。
part オブジェクト
ページネーション（ページ分割）の各ページリンクを表すオブジェクト。paginate オブジェクトの parts 配列の要素として、ページ番号、リンク判定、URL を含む。
currency オブジェクト
通貨情報を扱うオブジェクト。ISO コード、シンボル、通貨名を取得できる。
tax_line オブジェクト
チェックアウトまたは注文に適用される税金情報を表すオブジェクト。税種別の金額・税率・税率パーセンテージを保持する。
taxonomy_category オブジェクト
商品に紐付けられた Google Taxonomy（商品分類）カテゴリ情報を取得するオブジェクト。カテゴリの ID、名前、階層構造にアクセスできる。
localization オブジェクト
ストアで利用可能な国・言語、および現在選択されている市場・国・言語の情報を取得するオブジェクト。Shopify Markets や多言語対応を実装する際に使用する。
metaobject_system オブジェクト
メタオブジェクトの基本情報（型、ハンドル、ID、URL）にアクセスするシステムプロパティ。ユーザー定義フィールドとの名前衝突を避けるため、これらのプロパティは `system` オブジェクト配下にまとめられている。
selling_plan_price_adjustment オブジェクト
定期購入プランが商品バリアントの価格をどのように変更するかを表すオブジェクト。割引率、固定値割引、または新価格の3つの調整タイプに対応。
closest オブジェクト
現在のコンテキストにおいて最も近い商品、コレクション、記事、ブログ、ページ、またはメタオブジェクトリソースを参照するオブジェクト。テーマセクション・ブロックの設定値、祖先要素の設定値、またはテンプレートリソースから動的に取得される。
remote_shop オブジェクト
リモートストア（他のストアから取得した商品）の情報を保持するオブジェクト。ストア名、ブランドアセット、配送ポリシー、返金ポリシーにアクセスできる。
section オブジェクト
セクションの ID、設定値、ブロック配列、ページ内の位置情報（index）を提供するオブジェクト。テンプレートやセクショングループ内でセクションの動的な挙動をコントロールする。
policy オブジェクト
ストアの各種ポリシー（プライバシーポリシー、返品ポリシー、利用規約など）の内容と URL を取得するオブジェクト。Shopify 管理画面で設定したポリシーに Liquid からアクセスできる。
video_source オブジェクト
動画メディアのソースファイルに関する情報を保持するオブジェクト。ファイル形式、寸法、MIME タイプ、CDN URL などを提供する。
generic_file オブジェクト
メタフィールドの file_reference 型で参照されるファイル（画像・動画以外）。CDN URL、ファイル ID、プレビュー画像、メディア位置などのプロパティを持つ。
location オブジェクト
ストアの実店舗（ロケーション）を表すオブジェクト。ID、名前、住所、座標、メタフィールドなどの店舗情報を保持する。
selling_plan_group オブジェクト
商品に紐付いた定期購入プラン（サブスクリプション）をグループ化したオブジェクト。複数の定期購入オプション（月1回、3ヶ月ごとなど）をまとめて管理する。
shop_locale オブジェクト
ストアで利用可能な言語ロケールを表現するオブジェクト。言語名、ISO コード、ルート URL などのロケール情報にアクセスできる。
company オブジェクト
顧客が購入する対象の企業（会社）を表すオブジェクト。B2B 向けストアで、顧客が所属する企業の ID、名称、外部 ID、アクセス可能な拠点情報を取得できる。
font オブジェクト
テーマ設定の font_picker で選択したフォント情報にアクセスするオブジェクト。フォント名、ウェイト、スタイル、フォールバック指定などの属性を CSS に出力できる。
model オブジェクト
商品に紐付けられた 3D モデル（メディア）を表すオブジェクト。sources、alt、id、media_type、position、preview_image のプロパティで構成される。
unit_price_measurement オブジェクト
商品バリアントの単価測定情報を保持するオブジェクト。容積・重量・長さ・面積・個数などの単位でグラム当たりの価格を計算し、消費者に単価を提示するときに使う。
fulfillment オブジェクト
注文の配送実績情報を保持するオブジェクト。配送日時、追跡番号、配送事業者、配送対象商品などを参照できる。
product_option_value オブジェクト
商品のオプション値（色なら「赤」、サイズなら「M」）を表すオブジェクト。選択状態、在庫可能性、関連バリアントを参照できる。
media オブジェクト
商品に紐付いた画像、動画、3D モデル、外部動画を統一的に扱う抽象オブジェクト。id、media_type、preview_image、alt などのプロパティを持ち、メディアフィルターと組み合わせて URL 生成や表示を行う。
comment オブジェクト
ブログ記事に投稿されたコメントを表すオブジェクト。コメント作成者の名前・メールアドレス、コメント本文、投稿日時などのプロパティを持つ。
user オブジェクト
ブログ記事の著者情報を表すオブジェクト。著者の名前、メールアドレス、プロフィール画像、自己紹介文などを取得できる。
brand オブジェクト
ストアのブランドアセット（ロゴ、キャッチフレーズ、ブランドカラー、SNS リンク）にアクセスするオブジェクト。Shopify 管理画面の「ブランド設定」で構成された情報を Liquid で参照できる。
shipping_method オブジェクト
注文の配送方法に関する情報を保持するオブジェクト。配送方法名、金額、税金、割引内容にアクセスできる。
discount オブジェクト
カート、商品行、注文に適用された割引情報を保持するオブジェクト。割引額、種類、割引コード/タイトルを取得できる。
paginate オブジェクト
paginate タグで分割したコンテンツのページネーション情報を提供するオブジェクト。現在のページ番号、ページサイズ、全ページ数、前後のページへのリンク情報を含む。