メタフィールドのコンテンツタイプと値

メタフィールドの各タイプは、異なるユースケースのさまざまな値に対応しています。詳細については、メタフィールドのコンテンツタイプの以下の表を参照してください。

メタフィールドの各タイプのサポートされている値
メタフィールドの各タイプのユースケースの例
コンテンツタイプをメタフィールドリストとして使用できる場合

メタフィールドコンテンツタイプは、メタフィールドタイプの値に基づいてカテゴリー別にグループ化されます。たとえば、寸法、量、重量は、すべてのタイプの測定データで、測定カテゴリーにグループ化されています。メタフィールドコンテンツタイプは、以下のカテゴリーにグループ化されています。

日付と時刻
寸法
Number
テキスト
リファレンス
その他
Advanced

最も頻繁に使用されるメタフィールドタイプは、アクセスしやすくするために [使用頻度が最多] セクションにグループ化されています。

日付と時刻

日付と時間のメタフィールドタイプ。
コンテンツタイプ	説明	リストで使用する	例
日付と時刻	日付と時間の値。このメタフィールドタイプは、ISO 8601形式の日付値と、UTC時間の時間値に対応しています。	はい	イベントの公開日、または商品の発売日と時間を追加します。
日付	日付と時間の値。このメタフィールドタイプは、ISO 8601形式の日付値と、UTC時間の時間値に対応しています。	はい	イベントの公開日または商品の発売日を追加します。

寸法

測定メタフィールドタイプ
コンテンツタイプ	説明	リストで使用する	例
ディメンション	このメタフィールドタイプは、整数と小数の両方に対応しています。寸法では、メートル法またはインペリアル測定単位のいずれかを使用します。	はい	箱の高さ、またはスカーフの長さなどの商品の長さを追加します。
量	このメタフィールドタイプは、整数と小数の両方に対応しています。量では、メートル法またはインペリアル測定単位のいずれかを使用します。	はい	水筒の容積容量を追加します。
重量	このメタフィールドタイプは、整数と小数の両方に対応しています。重量では、メートル法またはインペリアル測定単位のいずれかを使用します。	はい	砂糖のグラム数など、商品や原材料の重量を追加します。

Number

数値メタフィールドタイプ
コンテンツタイプ	説明	リストで使用する	例
小	小数値は、+/-9999999999999.999999999の範囲内とし、整数は最大13桁まで、小数は最大9桁まで入力できます。	はい	宝石にカラット数を追加します。
Integer	整数値は、-4,611,686,018,427,387,904から4,611,686,018,427,387,903の範囲内を入力できます。	はい	本にページ数を追加します。

テキスト

テキストメタフィールドタイプ
コンテンツタイプ	説明	リストで使用する	例
複数行のテキスト	このメタフィールドタイプは、改行ありのプレーンテキストに対応しています。テキストの長さの下限と上限、正規表現ルールを選択できます。	いいえ	配送メモや返品ポリシーを追加します。
リッチテキスト	このメタフィールドタイプは、改行ありのテキスト、また見出しスタイル、太字、斜体、下線などのインラインスタイルに対応しています。リッチテキストで動作するテーマ設定のみと連携可能です。テーマによってスタイルの処理方法は異なり、あなたが設定したスタイルより優先適用される場合があります。使用しているテーマで実行されるリッチテキストメタフィールドのスタイル処理については、テーマのドキュメントを確認してください。	いいえ	ブランドや商品やスタイルに関する、長めのストーリーを追加します。
単一行のテキスト	このメタフィールドタイプは、改行なしのプレーンテキストに対応しています。単一行のフィールドを、メタフィールド定義の作成時に指定するプリセットの選択肢に限定することができます。	はい	短いメモや告知を追加します。

リファレンス

参照メタフィールドタイプ
コンテンツタイプ	説明	リストで使用する	例
会社又はその他の法人	このメタフィールドタイプは、メタフィールドリストの単一または複数の会社へのリンクに対応しています。	はい	管理画面の [会社] セクションに会社メタフィールドを追加して、関連する会社に連携させます。
お客様	このメタフィールドタイプは、メタフィールドリストの単一または複数のお客様へのリンクに対応しています。	はい	管理画面の [顧客管理] セクションにお客様メタフィールドを追加して、関連するお客様に連携させます。
商品	このメタフィールドタイプは、メタフィールドリストの単一または複数の商品へのリンクに対応しています。	はい	オンラインストアの商品ページまたはコレクションページ上に、特集商品を保存および表示します。
コレクション	既存のコレクションにリンクすることができます。このメタフィールドタイプは、メタフィールドリストの単一または複数のコレクションへのリンクに対応しています。	はい	ファッション商品の「トータルコーディネート」コレクションをオンラインストアに含めます。
商品バリエーション	このメタフィールドタイプは、単一の商品バリエーションへのリンクに対応しています。	はい	オンラインストアの商品ページで、同じ色の他の衣料アイテムを保存して表示します。
ファイル	このメタフィールドタイプは、以下のいずれかのファイルタイプで、単一ファイルのアップロードに対応しています。画像画像サイズは20MB以下にしてください。利用できるフォーマット：PEG、PNG、WEBP、HEIC、およびGIF テーマ設定で使用される際に画像として処理されます。ビデオビデオは1 GB未満で、長さが10分未満である必要があります。使用できる形式はMOVとMP4です。ビデオタイプのテーマ設定で使用されるとビデオとして処理され、画像タイプの設定で使用されると画像として処理されます。すべてのファイルタイプ一般的なファイルは20 MB未満である必要があります。テーマ内でダウンロード可能なリンクとして処理されます。サポートされているファイルタイプについては、「ファイル形式の要件」を参照してください	はい	組み立て指示のPDFファイルを追加します。
メタオブジェクト	単一または複数のメタオブジェクトエントリーへのリンクをサポートします。メタオブジェクトリファレンス (リスト) タイプは商品属性で使用され、バリエーションのオプションに接続できます	はい	選択した商品ページにカスタムインフルエンサープロフィールを追加して表示するか、商品のオプションに接続する
ページ	既存のページにリンクすることができます。このメタフィールドタイプは、メタフィールドリストの単一または複数のページへのリンクに対応しています。	はい	オンラインストアの商品に関するポリシーページまたは詳細なサポートガイドを挿入します。

その他

その他のメタフィールドタイプ
コンテンツタイプ	説明	リストで使用する	例
trueまたはfalse	条件がtrueまたはfalseかを選択するチェックボックスを作成します。	いいえ	アイテムに刻印できるかどうかなど、あるオプションが利用可能かどうかを追加します。
色	このメタフィールドタイプは、「#RRGGBB」`形式のRGB値に対応しています。`	はい	商品の色を保存し、商品ページの背景を同じ色に設定します。
評価	このメタフィールドタイプは、定義の設定方法に応じて、指定された記数法に沿った小数点以下の値に対応しています。	はい	商品のオーディエンススコアまたは星評価を追加します。
ID	このメタフィールドタイプは、固有の単一行テキスト値に対応しています。	いいえ	リソースのIDを別のシステムに保存します。
URL	このメタフィールドタイプは、「HTTP」`、「HTTPS」、「mailto:」、「sms:」、「tel:」のURLに対応しています。メタフィールドの定義を作成するときに、URLを特定のドメインに制限できます。`	はい	特定のウェブサイトでホストされている書籍レビューまたは商品ビデオへのリンクを追加します。
資金	このメタフィールドタイプは、整数と小数の両方に対応しています。通貨コードはストア通貨と一致する必要があります。	いいえ	仕入れ費用や倉庫への配送費用など、商品にかかる費用の詳細を追跡します。
リンク	このメタフィールドタイプは、改行なしの単一行プレーンテキストと、「HTTP」`、「HTTPS」、「mailto:」、「sms:」、「tel:」のURLに対応しています。メタフィールドの定義を作成するときに、URLを特定のドメインに制限できます。`	はい	特定のウェブサイトでホストされている書籍レビューまたは商品ビデオへのリンクを追加します。

Advanced

高度なメタフィールドタイプ
コンテンツタイプ	説明	リストで使用する	例
JSON	このメタフィールドタイプは、構造化データソースが必要な高度なユースケースで未処理のJSONデータに対応しています。	いいえ	原材料の表など、それぞれの列で異なる商品を扱う仕様表を追加します。
複合の参照	このメタフィールドタイプは、任意のタイプの参照に対応しています。このタイプをストアフロントで使用するには、開発者のサポートが必要です。開発者向けカスタムデータについて詳しくは、こちらをご覧ください。	はい	Hydrogenストアフロントに動的ランディングページを作成します。