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

メタフィールドの各タイプは、さまざまな使用例に応じて、サポートされている各種の値に対応しています。詳細については、以下のメタフィールドのコンテンツタイプに関する表を参照してください。

• 各タイプのメタフィールドでサポートされている値
• 各タイプのメタフィールドの使用例
• コンテンツタイプがメタフィールドリストとして使用できるかどうか

詳細については、メタフィールドに関する開発者ドキュメントを参照してください。

メタフィールドのコンテンツタイプは、その値のタイプによってカテゴリー分けされています。たとえば、ディメンション、体積、重量はすべて測定データのタイプであり、「測定」カテゴリーにまとめられています。メタフィールドのコンテンツタイプは、以下のカテゴリーにグループ化されています。

• 日時
• 測定
• 数字
• テキスト
• 参照
• その他
• 詳細

最もよく使用されるメタフィールドのタイプは、アクセスしやすくなるように、最もよく使用されるセクションにグループ化されています。

日時

日付と時刻のメタフィールドタイプ

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

測定

測定のメタフィールドタイプ

コンテンツタイプ	説明	リストでの使用	例
ディメンション	このメタフィールドタイプは、整数値と小数値の両方に対応しています。ディメンションでは、メートル法またはヤード・ポンド法の測定単位を使用します。	はい	箱の高さや、スカーフの長さなどの商品の長さを追加できます。
体積	このメタフィールドタイプは、整数値と小数値の両方に対応しています。体積では、メートル法またはヤード・ポンド法の測定単位を使用します。	はい	水筒の容量を追加できます。
重量	このメタフィールドタイプは、整数値と小数値の両方に対応しています。重量では、メートル法またはヤード・ポンド法の測定単位を使用します。	はい	商品や材料の重量 (例：砂糖のグラム数) を追加できます。
アンテナゲイン	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。アンテナゲインでは、等方性デシベルまたはダイポールデシベルの単位を使用します。	はい	ワイヤレスデバイスやネットワーク機器のアンテナゲインの定格を追加します。
面積	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。面積では、メートル法またはヤード・ポンド法の測定単位を使用します。	はい	ラグやタイルの対象面積など、商品の表面積を追加します。
バッテリー充電容量	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。バッテリー充電容量は、ミリアンペア時で測定されます。	はい	スマートフォンやノートパソコンのバッテリーなど、デバイスのバッテリー容量を追加します。
バッテリーエネルギー容量	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。バッテリーエネルギー容量は、ワット時で測定されます。	はい	バッテリーパックやモバイルバッテリーのエネルギー容量を追加します。
静電容量	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。静電容量では、ピコファラド、ナノファラド、マイクロファラド、またはファラドを使用します。	はい	電子コンポーネントの静電容量を追加します。
濃度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。濃度では、グラムあたりのミリグラム、またはミリリットルあたりのミリグラムを使用します。	はい	ミリリットルあたりの CBD 含有量など、成分の濃度を追加します。
データ保存容量	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。データ保存容量では、バイト、キロバイト、メガバイト、ギガバイト、またはテラバイトを使用します。	はい	USB ドライブやハードドライブの保存容量を追加します。
データ転送速度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。データ転送速度では、ビット/秒、キロビット/秒、メガビット/秒、またはギガビット/秒を使用します。	はい	ネットワーク機器や USB ケーブルの転送速度を追加します。
ディスプレイ密度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。ディスプレイ密度では、1インチあたりのピクセル数または1インチあたりのドット数を使用します。	はい	ディスプレイやモニターの画面解像度密度を追加します。
距離	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。距離では、キロメートルまたはマイルを使用します。	はい	乗り物の航続距離や機器の距離定格を追加します。
期間	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。期間では、ナノ秒から年までの単位を使用します。	はい	商品のバッテリー駆動時間や保証期間を追加します。
電流	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。電流では、ミリアンペア、アンペア、またはキロアンペアを使用します。	はい	充電器や電源の定格電流を追加します。
電気抵抗	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。電気抵抗では、オームまたはキロオームを使用します。	はい	電子コンポーネントの抵抗値を追加します。
エネルギー	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。エネルギーでは、ジュール、カロリー、キロジュール、またはキロカロリーを使用します。	はい	食品のカロリー量やデバイスのエネルギー出力を追加します。
周波数	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。周波数では、ヘルツ、キロヘルツ、メガヘルツ、またはギガヘルツを使用します。	はい	電子デバイスのプロセッサ速度またはワイヤレス周波数を追加します。
照度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。照度では、ルクスまたはフートカンデラを使用します。	はい	表面で測定されたランプの光出力を追加します。
インダクタンス	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。インダクタンスでは、マイクロヘンリー、ミリヘンリー、またはヘンリーを使用します。	はい	電子コイルや変圧器のインダクタンス定格を追加します。
光束	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。光束は、ルーメンで測定されます。	はい	電球や懐中電灯の明るさの出力を追加します。
質量流量	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。質量流量では、キログラム/時など、質量と時間を組み合わせたさまざまな単位を使用します。	はい	産業機器やディスペンサーなどの流量を追加します。
電力	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。電力では、ミリワット、ワット、馬力、またはキロワットを使用します。	はい	モーター、電化製品、電動工具の出力を追加します。
圧力	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。圧力では、ポンド毎平方インチまたはバールを使用します。	はい	タイヤ、ポンプ、高圧洗浄機の定格圧力を追加します。
解像度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。解像度では、ピクセルまたはメガピクセルを使用します。	はい	スマートフォンやデジタルカメラのカメラ解像度を追加します。
回転速度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。回転速度は、1分あたりの回転数で測定されます。	はい	モーター、ドリル、またはファンの RPM 定格を追加します。
音量レベル	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。音量レベルは、デシベルで測定されます。	はい	電化製品の騒音レベルやスピーカーの出力を追加します。
速度	このメタフィールドのタイプは、整数値と小数値の両方に対応しています。速度では、キロメートル/時、フィート/秒、マイル/時、またはメートル/秒を使用します。	はい	乗り物の最高速度や機器の定格風速を追加します。
温度	このメタフィールドのタイプは、整数値と小数値の両方をサポートしています。温度には、摂氏、華氏、またはケルビンを使用します。	はい	デバイスの動作温度範囲や、食品の提供温度を追加します。
熱出力	このメタフィールドのタイプは、整数値と小数値の両方をサポートしています。熱出力には、1 時間あたりの BTU、キロワット、または冷凍トンを使用します。	はい	HVAC 機器の暖房または冷房能力を追加します。
電圧	このメタフィールドのタイプは、整数値と小数値の両方をサポートしています。電圧はボルトで測定されます。	はい	電子デバイスや電源アダプターの定格電圧を追加します。
体積流量	このメタフィールドのタイプは、整数値と小数値の両方をサポートしています。体積流量には、毎分リットルなど、体積と時間を組み合わせたさまざまな単位を使用します。	はい	ポンプ、シャワーヘッド、または灌漑システムの流量を追加します。

数字

数値のメタフィールドタイプ

コンテンツタイプ	説明	リストでの使用	例
小数	小数値は +/-9999999999999.999999999 の範囲で、小数点の前が最大 13 桁、後が最大 9 桁となります。	はい	ジュエリーのカラット重量を追加できます。
整数	整数値は -4,611,686,018,427,387,904～4,611,686,018,427,387,903 の範囲となります。	はい	本のページ数を追加できます。

テキスト

テキストのメタフィールドタイプ

コンテンツタイプ	説明	リストでの使用	例
複数行テキスト	このメタフィールドタイプは、改行を含むプレーンテキストに対応しています。 最小長、最大長、および正規表現のルールを選択できます。	いいえ	発送に関する注意事項や返品ポリシーを追加できます。
リッチテキスト	このメタフィールドタイプは、改行や、見出しスタイル、太字、斜体、下線などのインラインスタイル設定を含むテキストに対応しています。 リッチテキストに対応したテーマ設定にのみ関連付けられます。 テーマによってスタイルの処理方法が異なるため、ここで適用したスタイルが上書きされる場合があります。リッチテキストのメタフィールドがテーマでどのようにスタイル設定されるかを詳しく理解するには、テーマのドキュメントを確認してください。	いいえ	ブランドや商品に関する長文のストーリーを、スタイル設定を含めて追加できます。
1行テキスト	このメタフィールドタイプは、改行を含まないプレーンテキストに対応しています。 1行テキストフィールドを、メタフィールドの定義の作成時に指定するプリセットの選択肢に限定できます。	はい	短いメモやお知らせを追加できます。

参照

参照のメタフィールドタイプ

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

その他

その他のメタフィールドタイプ

コンテンツタイプ	説明	リストでの使用	例
真または偽	条件が真か偽かを選択するためのチェックボックスを作成します。	いいえ	アイテムに刻印できるかどうかなど、オプションが利用できるかどうかを追加します。
色	このメタフィールドタイプは、#RRGGBB 形式の RGB 値に対応しています。	はい	商品の色を保存してから、商品ページの背景をその色に設定します。
評価	このメタフィールドタイプは、定義の設定に応じて、指定されたスケールに沿った小数値に対応しています。	はい	商品のオーディエンススコアや星評価を追加します。
ID	このメタフィールドタイプは、固有の1行テキスト値に対応しています。	いいえ	別のシステムにあるリソースのIDを保存します。
URL	このメタフィールドタイプは、HTTP、HTTPS、mailto:、sms:、tel: の各 URL に対応しています。メタフィールドの定義を作成する際に、URL を特定のドメインに限定することができます。	はい	特定のウェブサイトでホストされている書籍レビューや商品動画へのリンクを追加します。
金額	このメタフィールドタイプは、整数値と小数値の両方に対応しています。通貨コードはストア通貨と一致させる必要があります。	いいえ	販売代理店の費用や倉庫への配送料など、商品の費用詳細を追跡します。
リンク	このメタフィールドタイプは、改行のない1行のプレーンテキストと、HTTP、HTTPS、mailto:、sms:、tel: の各 URL に対応しています。メタフィールドの定義を作成する際に、URL を特定のドメインに限定することができます。	はい	特定のウェブサイトでホストされている書籍レビューや商品動画へのリンクを追加します。

詳細

高度なメタフィールドタイプ

コンテンツタイプ	説明	リストでの使用	例
JSON	このメタフィールドタイプは、構造化データソースが必要な高度なユースケースのために、未加工の JSON データに対応しています。	いいえ	商品ごとに異なる列を持つ仕様の表 (成分表など) を追加します。
複合の参照	このメタフィールドタイプは、あらゆるタイプの参照に対応しています。 ストアフロントでこのタイプを使用するには、開発者のサポートが必要です。開発者向けカスタムデータの詳細。	はい	Hydrogen ストアフロントで動的なランディングページを作成します。