Liquid構文の使い方について

EC出品テンプレートを作成する際に利用できるLiquid構文の基本的な説明と実際のユースケースをご紹介して解説します

Misano Yamada2025-05-20

EC出品テンプレートを作成する際に利用できるLiquid構文の基本的な説明と実際のユースケースをご紹介して解説します。

EC出品を効率化するためにEC出品テンプレート利用し、出品作業は効率化されたものの、テンプレート数が多く、買取時に入力した情報を出品時に再度選択する必要がある場合には、Liquid構文を使ってEC出品テンプレートを作成することで複数の出品テンプレートを集約して作成が可能になるなどより効率化を図ることが可能です。

こちらでは、在庫やカタログの情報を元により効率的にECテンプレートを作成するために、ユースケース毎のサンプルの構文を用意してあります。

Liquid構文とは、Shopifyなどで使われているLiquid template languageを用い、変数の展開やif文などを実現するものです。

『構文』『変数』『if文』など普段聞きなれない言葉ばかりではありますが、各ユースケースのガイドに従って作成することができます。ユースケースに沿って、次のようによく使われている『if文』の例を元にLiquidについてご確認ください。

No

Liquid構文

日本語

1

ReCOREの【グレード】情報を元にECサイト状態を指定する場合

{% if item.grade.name == ‘新品’ %} 新品 {% elsif item.grade.name == ‘中古A’ %} 中古品-非常に良い {% elsif item.grade.name == ‘中古B’ %} 中古品-良い {% endif %}

もし、グレードが新品である場合 新品 もし、グレードが中古Aである場合 中古品-非常に良い もし、グレードが中古Bである場合 中古品-良い 構文終わりの定型文

活用例の解説

上記は対応する箇所を、文字の色や背景色で視覚化し、Liquid構文を日本語に変換したものです。

item.grade.nameは、店頭買取など在庫に指定している【グレード】を指します。 ==は、前後の文字を比較し等しいを意味し【である】を表します。 なお、!=は、等しくないを意味し【でない】を表します。 条件を表す『if文』は、{% if ~~ %}で始まり、最後は、{% endif %}で締め括ります。

No

画像

項目

概要

構文例

1

変数

変数を使用する場合は、変数を『 {{ }}』出力タグ:Output tag) で囲む

▼使用可能な変数 【Ctrl】キー+【Space】キーをクリック時に表示される選択肢の中で、右側に『string』または『array〈string〉』と表示されるもの

{{ product.attribute.jan }}

スペースの有無は関係なく、以下の記載も問題ありません。 {{product.attribute.jan }}

2

フィルタ

フィルタを使用する場合は、適用するフィルタ前に『|』(パイプ 記号)を記載

▼構文例 カタログ画像のURL(product.image_urls)をカンマで繋いで出力します。

▼使用可能な変数フィルタ join:配列を指定した区切り文字で結合 map:配列内のオブジェクトから特定のキーの値を抽出 split:文字列を指定した区切り文字で分割 uniq:配列内の重複要素を削除 【Ctrl】キー+【Space】キーをクリック時に表示される選択肢において、右側に『filter』と表示されるもの

{{ product.image_urls | join: ‘,’ }}

3

構文

if文などの構文を使用する場合は、文頭に『{%』文末を『 %}』 で囲む

▼構文例 在庫画像(item.image_urls.size)がある場合は在庫画像URL(product.image_urls)のみ、ない場合はカタログ画像URL(product.image_urls)を出力します。

▼使用可能な if:条件分岐 elsif:追加条件 else:デフォルト処理 for:ループリスト(配列)の要素を繰り返し処理する break:ループ終了 continue:次のループへスキップ assign:変数の定義 【Ctrl】キー+【Space】キーをクリック時に表示される選択肢において、右側に『snippet』と表示されるもの

{% if item.image_urls.size > 0 %} {{ item.image_urls | join: ‘,’ }} {% else %} {{ product.image_urls | join: ‘,’ }} {% endif %}

Liquid構文でECサイトの選択肢を指定する際の注意点

各ECサイトの出品項目をLiquidで指定する場合、表示名ではなくIDを指定 する必要があります。

コンディションやカテゴリなどでは、IDを出力するようにLiquidを記述してください。 例:Amazonのコンディション指定 表示『中古 – 非常に良い』 →ID『UsedVeryGood』を出力

IDの調べ方

以下の2つの方法で確認できます。

方法①:デフォルトモード → Liquidモードで確認

  • 通常モードで選択 → Liquidモードに切り替えるとIDが表示

方法②:Liquidモードで【Ctrl】+【Space】を押す(推奨)

  • 表示される選択肢の中で、右側が const のもの を選ぶ

例外:カテゴリ・ブランドなど大量の選択肢は非対応のため 方法①で確認するか、別途ID一覧表を用意

カンマ区切りで複数指定できるカラム(例:商品画像、Shopifyタグなど)では、適切に区切る必要があります。 💡 見分け方:「Liquidモードで空欄にすると ‘カンマ区切りで入力してください’ と表示されるカラム」

例:Shopifyタグの指定

{{ product.title }},あいうえお,{{ item.code }}

🔽 システム内部で次にように展開されます

商品タイトル,あいうえお,IT0000000000

✅ 結果:3つのタグとして認識

「商品タイトル」「あいうえお」「IT0000000000」

配列型の変数 を使用する場合、そのまま出力すると意図しない形になることがあります。 👉 変数例:product.image_urlsproduct.category.names など 💡 解決策join フィルターを使用し、適切に区切って出力する

{{ product.image_urls | join: ',' }}

適切な形式で出力されるように調整

{{ product.category.names }},あああ,いいい

  • product.category.names は配列なので、そのまま出力すると 区切りなしで連結 される。

  • その結果、「家電テレビ20インチ」 という1つのタグになってしまう。

{{ product.category.names | join: ',' }},あああ,いいい

  • join: ',' を適用すると、配列がカンマ区切りの文字列に変換される。

  • その結果、タグとして 「家電」「テレビ」「20インチ」 が個別に認識される。

 

補足:コメントアウト

{% comment %} ... {% endcomment %} の間のテキストは Liquid の処理で無視される コードの横に 対応するカテゴリ名をコメントで書いておく と、後で編集・確認しやすい Shopify の管理画面やテーマエディタでコードを見たときに、カテゴリの意味が分かりやすくなる

{% if item.grade.name == ‘中古A’ %}

used10 {% comment %} 未使用に近い {% endcomment %}

{% elsif item.grade.name == ‘中古D’ %}

used80 {% comment %} 全体的に状態が悪い {% endcomment %}

{% endif %}

入力項目の下にある【Liquid】をクリック

Liquid入力画面が表示されます。

入力可能な構文、変数、フィルタなどは【Ctrl】キー+【Space】キーをクリック時に表示される選択肢をクリックすることでスムーズな入力が可能です。

▼【Liquid】入力状況で【デフォルト】をクリックすると、通常の入力方法に切り替わります。

 

▼【デフォルト】入力へ切替後:Liquidで入力中の内容が削除されますので、ご注意ください。

【新規作成する】または【保存する】をクリックして必ず保存します。

保存しない場合は、作成内容が消えてしまいますので、ご注意ください。

利用目的に合わせたヘルプガイドを作成しております。サンプルコードと編集方法が記載されています。編集方法に従って作業していただくだけで作成できるので、参考ガイドURL列を参考にご活用ください

No

利用モール分類

ユースケース

参考ガイドURL

1

全モール共通

ReCOREのグレードを元にECモール側の状態を指定したい

https://www.notion.so/novasto/ReCORE-EC-37b79d14517a44148d7f2e80f18d8537

2

全モール共通

ECモール側のカテゴリをReCOREのカテゴリを元に指定したい

https://www.notion.so/novasto/EC-ReCORE-c3a460e248c04f2c86fa5e87109667f0

3

モール共通 但し、メルカリShops、 楽天ラクマを除く

表形式の商品説明文を作成する際に、テンプレート数を抑えたい

https://www.notion.so/novasto/7763738a560b444b8bb39d46b2c38f44

4

モール共通 但し、メルカリShops、 楽天ラクマを除く

商品説明文で対象状態(グレード)をフォーカスさせるテンプレートを作成したい

https://www.notion.so/novasto/f944ca4c95364bc595f8e9df992d4575

5

ヤフーオークション

出品終了の曜日を指定したい

https://www.notion.so/novasto/a2d1a36e18b0475e8f24f586fc8e44a1

6

メルカリShops

商品説明文を作成する際に、テンプレート数を抑えたい (HTMLなし)

https://www.notion.so/novasto/HTML-a74e1f10659a4906b969acb62213cdcd

7

メルカリShops

ReCOREのブランド情報を元にメルカリのブランドを指定したい

https://www.notion.so/novasto/ReCORE-94b397944a404eff8e34fb681c56099e?pvs=4

お手数ではございますが、ReCOREのチャットよりお問合せください。

お問合せの際は、以下をご確認のうえお問合せください。 ・EC出品テンプレートにおける不明な点 ・設定するECサイト ・お客様より設定操作された具体的な内容

一方で、具体的なHTMLやLiquid構文内容のコード記載内容における詳細な設定方法については、ご案内が難しい場合もございますのでご了承ください。

解説は以上です。

不明な点は、ReCOREチャットよりお問合せくださいませ。