2つのオプションが組み合わせられた形で1つのバリエーションになります。
-本文中

(最終更新 2024年10月27日)

【Shopify小技】商品一覧にオプション「画像」表示させる最もシンプルなLiquidコード

自作商品一覧に商品のオプション画像させる、最もシンプルなLiquidコードを紹介いたします。ただし、1つのオプションしか持たない商品に使用を推奨します。

本サイトでは以前、自作で「特定コレクションの商品一覧」を作成する手順を、2回に分けて紹介しました。

Shopify 自作で「商品一覧」を作る!カスタマイズ画面で簡単に指定できるスキーマ設定

Shopify 自作で「商品一覧」を作る!HTMLとLiquidの書き方を解説

また商品一覧に「ディスカウント前後の金額」「割引率」を表示させる手法について解説した記事も先日公開しております。

商品一覧に「ディスカウント前後の金額」「割引率」を表示させたい

今回はこれらに加え、商品のオプション画像させる、最もシンプルなLiquidコードを紹介いたします。

メリット

商品一覧に各商品のバリエーション画像を設置する事で、最も期待されるメリットは、ユーザー体験を向上だと思います。

顧客が購入前に異なるオプション(色やデザイン)を視覚的に把握しやすくなるので、提供されている選択肢が一目で分かり、購入を促進します。

前提

オプションが2つ以上の場合、たとえば、

・色
・サイズ

だと、2つのオプションが組み合わせられた形で1つのバリエーションになります。

・赤/Mサイズ
・赤/Lサイズ
・青/Mサイズ
・青/Lサイズ

もちろん、バリエーションを成すオプションの数に制限はありません。

ここで紹介するサンプルコードは、バリエーションの情報を取得し、表示するためのLiquidコードです。

そのため、1つのオプションしか持たない商品に使用することを推奨します。(オプションが2つ以上の場合については、後述します。)

サンプルコード

まず、サンプルコードを見てみましょう。

{% for variant in product.variants %} 
    <img src="{{ variant.image.src | img_url: 'medium' }}" alt="{{ variant.title }}">
{% endfor %}

※商品一覧の中に挿入するコードなので、コレクション指定と商品ループのliquidコードは省略しています。

①まずfor文を使い、商品のバリエーションを1個ずつ取り出し処理します。

②バリエーションの画像のURLを取得するLiquidオブジェクトを使用し、画像を表示させます。

③バリエーションのタイトルを取得するLiquidおぶじゃを使用し、画像のalt属性を作成します。

オプションが複数ある場合

では、「色」「サイズ」「男/女」など、オプションが複数ある場合、特定のオプションの画像を商品一覧に表示させる手法について考察したいと思います。

表示/非表示

もし、上記のようなシンプルなコードで実装したいけど、商品によってはオプションの数が1つのものもあれば、2つ以上のものもある‥という場合は、選択的に表示/非表示の仕組みを作るのもいいと思います。

表示/非表示を制御するのは、メタフィールドの真偽値 (boolean)で実装できるかと思います。

{% if product.metafields.custom.boolean_value == true %}
<!-- Trueの処理 -->
{% for variant in product.variants %}
<img src="{{ variant.image.src | img_url: 'medium' }}" alt="{{ variant.title }}" />
{% endfor %}
{% endif %}

特定のオプションの画像を表示させる

どうしても全商品一律に「色」など、特定オプションを表示させたい!という場合は、少々複雑なコードになります。

{% assign color_variants = product.options_by_name["色"] %}
{% if color_variants %}
{% for color in color_variants.values %}
{% for variant in product.variants %}
{% if variant.option1 == color %}
<a href="{{ product.url }}?variant={{ variant.id }}">
<img src="{{ variant.image.src | img_url: 'medium' }}" alt="{{ variant.title }}">
{% break %}
{% endif %}
{% endfor %}
{% endfor %}
{% endif %}

他の手法としては、商品が持つ1番目のオプション(option1)の画像情報を取得して表示させる方法もあります。

これらの解説は、また別の記事で紹介したいと思います。

初めまして。運営者ホリと申します。

当ブログは「Shopifyを一緒に悩んで楽しむ仲間」に向けて情報を発信するブログです。

ここで扱うテーマは、構築やカスタマイズにとどまらず、SEOマーケティングやロジスティクスといった運営全般に広がります。

中でも最も重要視するのは、Shopifyを使った構築や運営に携わる中で「大掛かりな開発と投資に頼らなくても目的を達成できる工夫」。

確かな知識と経験を土台にしながら、日々の学びを記事にまとめて、同じように試行錯誤している方々とシェアしています。 日々の実践から得た知見を記事にまとめることで、Shopifyを使う仲間たちの小さなヒントや発想のきっかけになればうれしいです。

「ちょっと聞いてみたい」「これで大丈夫?」といった気軽な相談も大歓迎です。 Shopifyを通じて一緒に試行錯誤しながら、学び合える場として、このサイトを活用していただければ幸いです。

このブログと運営者について

お問い合わせ

BLOG More

設定

1週間前

【Shopify豆知識】テーマレイアウトをカスタマイズしたい?なら「grid-template」を知っておくべき

「スマホではロゴを左側に、PCではロゴを中央に」といった調整も、「grid-template」の設定次第で柔軟に実現できます。..

Liquid

4週間前

【Shopify小技】PC版に左のサイドバーを設置!まず「theme.liquid」の構造を知ろう

もし「type」を設定しなかったり、誤って設定したりしてしまうと、Shopifyはそのセクションをどの領域に表示すべきか判断できません。..

設定

1か月前

【Shopify小技】商品ページごとのFAQをメタオブジェクトで実装してみた

実際には「ピックアップ可能な店舗情報」や「割れやすい商品の配送注意点」など、商品ごとに異なる補足情報‥..

Liquid

1か月前

【Shopify Liquid】テーマで実際使用される「render」の引数と渡り値 その役割を解説

それぞれの変数の意味を押さえておけば、ある程度は読み解くことができると思います。..

アプリ

1か月前

【Shopifyアプリ】シンプル&レスポンシブ!直感的に使えるカレンダー「The Shop Calendar」でイベント・営業日を表示

The Shop Calendarは、カレンダー形式・一覧形式に加え、現在(2025年9月時点)β版としてアコーディオン形式にも対応しています。..

アプリ

2か月前

写真ギャラリーが複数作成できる!Shopify無料アプリ「GA Image Gallery」

ただし、「Advanced Setup」の方は動画を見ても最初はすんなり理解しづらいかもしれません。..

SEO

2か月前

【Shopify豆知識】だからSEOに強いのか!構造化データ(JSON-LD)について解説

しかし実際には、検索結果やGoogleショッピングにおいて、価格や在庫、バリエーション情報を正しく表示するための大事な役割を担っています。..

Liquid

2か月前

【Shopify豆知識】スキーマ設定(JSON)「t:」から始まる文字列とは‥実は変数パスではない?

Shopifyは「"t:"」以下のパスをたどって "label" の値(ここでは「クマさんのお顔」)を取得し、テーマエディタ上で表示します。..

Liquid

3か月前

【Shopify Liquid】スニペットファイルを呼び出す「render」引数と渡り値とは?

この仕組みによって、スニペットは渡されたデータに基づき、表示ロジックに沿って商品画像や商品名、価格などを表示できるようになります。..

制作アイディア

3か月前

Shopify構築をフリーランスへ代行依頼する手順(1~6)と選ぶポイント

私自身の体験としておすすめしたいのが「電話対応ができるフリーランス」を選ぶことです。..

Liquid

3か月前

【Shopify Liquid】オブジェクトの絞り込みに用いる「where」フィルタとは

たとえば、「販売元(vendor)」が「Nintendo」の商品だけを抽出したい場合は、以下のように書きます。..

制作アイディア

3か月前

Shopify構築をフリーランスへ依頼するメリットは費用だけではない!課題点も紹介

その「必死さ」や「ファイティングスピリット」は、柔軟かつ誠実な対応として依頼主にとって大きな安心材料となることも..

制作アイディア

3か月前

【リアルレポート】Shopify構築をフリーランスに依頼する際の相場と費用内訳

ECストアは今や単なる販売ツールではなく、実店舗と同じ、あるいはそれ以上に重要性と存在感を持つものとなっています。..

Js

3か月前

Shopifyにおける「カート追加」の仕組みを理解する!form送信 vs fetch API活用

fetch APIに用いられる「/cart/add.js」は、form送信の「/cart/add」と同様、「仮想的なエンドポイント」になります。..

Js

4か月前

【JavaScript】Shopify「cart.js」を読み解くための「Webコンポーネントメソッド」一覧

商品数や金額といった情報は、HTMLの「data-attribute」を使って要素ごとに管理されており、JavaScript側でそれを読み取って処理‥..

Js

4か月前

Shopifyのカスタマイズに役立つJavaScript「配列メゾット」11選を初心者向けに解説

「2005年新着!夏の水着一覧」という配列があるとします。最安値順に並び替えたいとき、「.sort()」というメソッドを使えば‥..

Js

4か月前

ShopifyではLiquidがあるのになぜJavaScriptが多用されるの?

その理由を一言で言えば、「Liquidは表示前、JavaScriptは表示後に働くから」です。..

Liquid

4か月前

Shopify 関連やおすすめ商品リストが自動生成「recommendations」活用・応用シーン

しかしカートページには、そもそも表示中の商品が存在しないため、このレコメンドの仕組みが機能しないのです。..

Liquid

4か月前

【Shopify Liquid】関連商品・おすすめ商品作成に用いられるオブジェクト「recommendations」について

このオブジェクトは、顧客の行動やストア内でのさまざまなデータを基に、自動的に関連商品を選出します。..

SEO

5か月前

Google、AIモードの導入を発表!収益減少が懸念される中、最も有力なマネタイズとは

このホテル、評価高いし、割引ついてるよ。数ステップで簡単に予約できるけど、今やる?..

SEO

5か月前

AI時代のSEOはオワコン?その真実と「違います」と言える4つの理由

たとえば「近くのコンビニを教えて」といったシンプルな質問に、毎回AIが複雑な推論や自然言語生成をしていたら、とんでもないコストになります。..

設定

5か月前

【Shopify豆知識】ヘッドレス(Headless)ってなに?

少し不気味で怪談を連想させるような響きですが、実際にはShopifyのメリットとして注目されている仕組みのひとつです。..

Liquid

5か月前

【Shopify小技】商品の「カートに追加」の仕組みをシンプルに解説(サンプルコード))

この仕組みにはLiquidだけでなく、JavaScriptやAjax、さらにはサーバー側で動くRubyなど、複数の技術が関わっている..

Liquid

5か月前

カートのノーティフィケーションやドロワーで1注文での同時購入を防ぐ方法は可能?

ノーティフィケーション(画面上部に一瞬表示される通知型カート)については、やや難易度が高めです。..

Liquid

5か月前

【Shopify Liquid】カート内で1つの注文に同時購入を防ぐシンプルな方法

ここで使われているのが、Liquidでよく用いられる「フラグ(真偽)」という考え方です。..

STORY

5か月前

なぜ鳥の巣はあんなに頑丈なのか?成功における「うまくいかない瞬間」の重要性

鳥の巣の初期段階のように、私たちの挑戦も、最初は失敗と不安定の連続です。..

Liquid

5か月前

【Shopify Liquid】商品ページの「オプション」を色か画像にしたい

そもそもShopifyの商品オプションに画像や色を登録できるのか?..

STORY

5か月前

現代言語哲学の巨人が教えてくれた「失敗する人の口癖」とは

あの時もし、あの会社に転職していたら・・..

アプリ

5か月前

【Shopifyアプリ】商品ページから簡単に見積もりを送信!履歴から下書き注文作成も可能

旅行会社、工事や建築、リフォーム業、OEM制作、ノベルティ制作、レンタル業なども十分対応できる‥..

STORY

6か月前

40代・50代にとって新たな挑戦が「苦痛」である理由・・私が救われたニーチェの言葉

苦しみがあるからこそ、深みが生まれる。..