ファイル(リスト)メタフィールドの表示方法が知りたい

Topic summary

Dawnベースの商品詳細に、デフォルト画像とは別の複数画像を表示したいという要件。商品メタフィールド「ファイル(リスト)」の表示方法が不明。単一ファイルは metafield_tag で表示できるが、リストの方法が見つからないという相談。

最新の更新・確認事項:

  • 管理画面に「ファイル(リスト)」タイプは存在。ドキュメントでは見つけづらかったが確認済み。
  • Liquidで product.metafields.custom.xxxxx.value を for ループで反復処理することで出力可能。

提示された実装例:

  • value を配列として扱い、各 file を処理(例: split:'/ʼ | last でファイル名取得)。必要に応じて画像タグに差し込んで表示。

技術補足:

  • メタフィールド=商品等に紐づく追加データ。ファイル(リスト)=複数ファイルを格納可能なタイプ。Liquid=Shopifyのテンプレート言語。
  • 「ファイル(リスト)」専用の特別なフィルターは不要で、配列を繰り返す基本処理がポイント。コード例が中心。

結果・ステータス:

  • 投稿者が解決を確認し感謝。議論は解決済み。
Summarized with AI on February 14. AI used: gpt-5.

はじめての投稿になります。

Dawnをベースにサイトを構築中です。

商品詳細ページにおいて、デフォルトの商品画像とは別に複数画像を表示するエリアを設けたいと考えています。
メタフィールドを利用し商品管理画面にファイル(リスト)の入力欄を設けましたが、main-product.liquid内から画像を表示する方法が分かりません。

試しに商品管理画面にファイルの入力欄を設置し、下記記述で単一の画像を表示することはできました。
{{ product.metafields.custom.xxxxx | metafield_tag }}

ですがファイル(リスト)メタフィールドの表示方法はリファレンス等からも見つけることがでませんでした。
解決法をご存知の方がおりましたら、ご教授お願いいたします。

興味があるため質問させていただきたいのですが、記載されている「ファイル(リスト)」というタイプのメタフィールドはどういうものでしょうか?

ドキュメント内に「ファイル(リスト)」というもの自体が見つけられないものでして。

「ファイル(リスト)」に関するドキュメントやヘルプをお教えいただければと思います。

参考

https://help.shopify.com/ja/manual/metafields/metafield-definitions/metafield-types

https://shopify.dev/api/liquid/filters#metafield_tag

大変申し訳ありません、実際に管理画面にあるのですね。

見落としておりました。

他にも方法があるかもしれませんが、試したところ以下で出力できました。

{% for file in product.metafields.custom.xxxxx.value %}
    {% assign file_name = file | split: '/' | last %}
    
  {% endfor %}

Jizo_Inagaki様
解決方法のご提案ありがとうございます。
参考のURLも拝見させていただきました。
ファイル(リスト)というメタフィールド専用の処理があるだろうという先入観を持っていたため、
オブジェクトの基本的な処理に関して調べることを怠っていました。
valueに対して繰り返し処理をかける必要があったのですね。
重ねて感謝いたします。