メタフィールド定義の構成部分

メタフィールド定義によって、メタフィールドを適用するストアの構成部分とメタフィールドに入力できる値が指定されます。以下のタスクを実行する前に、メタフィールド定義の構成部分を理解するようにしてください。

• カスタム定義を作成します。
• 既存のメタフィールドを定義に移行します。

メタフィールドの定義は、以下の部分から構成されています。

• 名前：Colorなど、管理画面でメタフィールドを特定するために使用されます。
• ネームスペースとキー：メタフィールドの固有のIDです。ネームスペースを使用して類似のメタフィールドをグループ化できますが、各ネームスペースとキーは固有である必要があります。例えば、custom.colorです。
• 説明 (任意)：メタフィールドに入力する値などの説明情報を含めることができます。
• タイプ：メタフィールドが保存するデータのタイプ (テキスト、ファイル、URLなど)。
• カテゴリー (標準商品メタフィールド定義のみ)：標準商品メタフィールドが関連付けられている標準的な商品カテゴリーです。
• 検証 (任意)：文字制限、最小値、最大値など、値の入力のルールです。
• オプション：メタフィールドはここで使用できます。
  • アクセス：ストアフロントへのアクセス権をメタフィールドに付与できます。つまり、メタフィールドは動的ソースを使用してテーマ内で接続できるようになります。アクセス権について、詳しくはこちらをご覧ください。
  • 機能：[管理画面で絞り込みとして使用する] により、管理画面でメタフィールドを使用して商品の検索結果を絞り込むことができるようになります。商品の絞り込みについて、詳しくはこちらをご覧ください。[自動コレクションで使用する] により、メタフィールドを使用して自動コレクションを作成できるようになります。メタフィールドによる自動コレクションについては、詳しくはこちらをご覧ください。

たとえば、商品の賞味期限のメタフィールド定義には、products.expiration_dateのキー、日付の値、YYYY/MM/DDの形式で日付を入力してくださいという説明が含まれる場合があります。その検証では、2025/07/01から2030/12/31までの日付の値のみが有効と指定することができます。

メタフィールド定義の構成部分の詳細については、以下の表を参照するか、「メタフィールドの開発者ドキュメント」を確認してください。

メタフィールド定義の構成部分

Name	説明
ネームスペースとキー	ネームスペースとキーを合わせて、メタフィールドの固有IDを作成します。これらは「.」で区切られ、文字、数字、アンダースコア (_)、ハイフン (-) のみを含めることができます。 ネームスペースを使用して類似のメタフィールドをグループ化できますが、それぞれのネームスペースとキーの組み合わせは固有である必要があります。たとえば、ネームスペース「products」を使用して、商品メタフィールドのキー「expiration_date」および「rating」をグループ化することができます。 標準定義では、標準化されたネームスペースとキーが使用されますが、カスタム定義では、編集可能な自動的に生成されたネームスペースとキーが使用されます。
値	メタフィールドに含まれる情報のタイプと形式。たとえば、プレーンテキスト、URL、整数。 メタフィールドには、コンテンツタイプでサポートされている値のみを追加できます。一般的なメタフィールドのタイプでサポートされている値について詳しくは、「メタフィールドのコンテンツタイプと値」を参照してください。
説明 (任意)	正しい値を入力するのに役立つメタフィールドの説明。説明は、メタフィールドの値を追加する管理画面のページに表示されます。
検証 (オプション)	メタフィールドに入力できる値を限定するために設定できます。最小値と最大値を設定したり、正規表現を使用してメタフィールドで使用できる値の範囲を管理したりすることができます。