Shopifyメタフィールド: 完全なセットアップと表示ガイド

Shopifyメタフィールドは、ストアリソース(製品、コレクション、注文、顧客、バリアント、その他)に付与するカスタムキー値フィールドであり、Shopifyのコアスキーマが本来提供していないデータを保存します。データ型を定義し、検証を施行して、その値をあらゆる場所に表示できます。Liquidを使用したストアフロント、ShopifyQLを使用した分析、Shopify Functionsを使用したチェックアウト、またはGraphQL Admin APIを使用した外部システムです。このループ(定義、入力、表示)が、必要な完全なメンタルモデルです。

重要なポイント

• メタフィールドは、3つのもので識別されます。オーナーリソース、ネームスペース、キーです。いずれかを変更すると、異なるフィールドを参照することになります。
• ShopifyのSpring 26とSummer 26 Editionsには、複数のメタフィールドアップグレードが搭載されました。管理ページに最大50フィールドをピン留めし、カートメタフィールドを注文に引き継ぎ、在庫転送時のメタフィールドを提供し、ShopifyQLドット構文フィルタリングを実現しました。
• Admin GraphQL API 2026-07リリース候補では、別のmetafieldsSet呼び出しなしで、在庫転送に直接メタフィールドを定義および設定できます。
• 定義を作成してもストアフロントには何も表示されません。テーマエディタの動的ソースを使用してフィールドを接続するか、Liquidを自分で記述する必要があります。
• 標準定義(ケア指示、成分、サイズ、ISBNなど)は、事前に設定されており、テーマと互換性があり、アプリ間で相互運用可能であるため、最速のパスです。

Shopifyメタフィールドとは正確には何ですか。

メタフィールドを使用すると、製品やコレクションなどのShopifyリソースに追加情報を付与できます。データは、仕様、サイズチャート、ダウンロード可能なドキュメント、リリース日、画像、または部品番号です。すべてのメタフィールドは、型情報と共に値を保存し、そのオーナーリソース、ネームスペース、およびキーによって識別されます。

ネームスペースをフォルダ名と考え、キーをそのフォルダ内のファイル名と考えてください。namespace: customとkey: materialのメタフィールドは、namespace: specsとkey: materialのメタフィールドとは完全に独立しています。どちらも同じ製品上に存在しますが。

3つの所有モデル

所有権を理解することで、変更を意図していないデータを誤って上書きするのを防ぐことができます。

マーチャント所有メタフィールドは、予約済みでないネームスペース(custom、specs、inventoryなど)を使用します。インストールされているすべてのアプリが、それらを読み書きできます。複数のアプリが使用する共有データに最適です。

アプリ所有メタフィールドは、予約済み$appネームスペースプレフィックスを使用します。所有アプリが構造と値を制御し、デフォルトではadminで読み取り専用です。1つのアプリがデータの信頼できるソースである場合に使用します。

アプリデータメタフィールドは、特定のアプリのインストール環境に結合され、Shopify adminから完全に非表示です。AppInstallationリソースに存在し、所有アプリによってGraphQL経由またはLiquid内のappオブジェクトを通じてのみアクセスできます。これらは、マーチャントに表示されるべきではない内部アプリの状態用です。

Shopifyは、標準定義などのプラットフォーム管理フィールド用に、Shopify予約済みネームスペース(shopify--プレフィックス付き)も維持しています。

メタフィールドのデータ型: 実践的なマップ

Shopifyはタイプをカテゴリに分類しています。正しいタイプを選択することは、検証の施行、Liquidが値をレンダリングする方法の制御、および適用されるフィルタを決定するため重要です。

テキスト

• single_line_text_field、製品バッジ、短いラベル、ISOコード
• multi_line_text_field、成分リスト、ケア指示(改行が保持されます)
• rich_text、フォーマットされた長形式のコンテンツ(見出し、太字、リスト)。metafield_tagフィルタでレンダリングしてください

数値と測定

• number_integer、number_decimal
• dimension、volume、weight。それぞれ数値と単位のペアを保存し、製品仕様と配送ルールに最適です

日付と時刻

• date、date_time、起動日、有効期限、イベントスケジュール

参照

• product_reference、collection_reference、page_reference、variant_reference。1つのリソースを別のリソースにリンクしますが、データを複製しません
• metaobject_reference。メタオブジェクトエントリにリンクします(以下を参照)
• article_referenceとlist.article_reference。2025-10 APIリリースで追加されました。製品をブログ記事に直接結合して、コンテンツドリブンコマースとSEOを実現します

その他の有用なタイプ

• boolean。機能フラグ、「新着」トグル、販売から非表示マーカー
• color。16進数ベースの色値とネイティブスウォッチサポート
• url、file_reference。ダウンロード可能なPDF、仕様シート、ビデオ
• json。任意の構造化データ。有用ですが、検証とレンダリングが難しくなります

リスト型の場合、任意のスカラー型にlist.をプレフィックスしてください(例: list.single_line_text_field)。これらはLiquidで配列としてレンダリングされ、フィールドが複数の値を保持できる場合(材料のリストや取得位置のセットなど)が最適です。

重要な制約: GraphQL Admin APIを使用する場合、メタフィールド値は、宣言されたタイプに関係なく、常に文字列として入力および保存されます。Shopifyは読み取り時に型強制を処理します。

メタフィールド定義: なぜ重要なのか

APIを通じて生のメタフィールド(定義なし)を記述できますが、定義がほぼ常に正しい選択です。メタフィールド定義は、そのネームスペース-キーの組み合わせのすべての値が従う必要があるスキーマを確立します。これには、データ型と検証制約が含まれます。定義は、GraphQL Admin API、Storefront API、およびCustomer Account API全体でのアクセス権限も制御し、フィールドをadminフィルタリングまたはコレクション条件として使用できるかどうかを決定します。

定義で構築することは以下を意味します。

• Admin UIサポート。定義されたフィールドは、カスタムコードなしですべての関連リソースの編集ページに表示されます。
• 検証。無効な値がストアフロントを破損する前に捕捉されます。
• フィルタリング。スマートコレクション条件またはadminフィルタとして定義されたフィールドを使用できます。
• テーマエディタの発見。動的ソースピッカーは定義されたフィールドのみをサーフェスされます。

標準定義は、ISBN番号、製品成分、およびケア指示などの一般的なユースケースのための事前構築されたスキーマです。これらを使用することは、それらの標準ネームスペースを参照するアプリとテーマが、追加設定なしで既にデータを読む方法を知っていることを意味します。

ステップバイステップ: 定義を作成して入力する

Shopify admin内(コードなし)

1. 設定 > カスタムデータに移動します。
2. リソースタイプ(製品、顧客、注文など)を選択します。
3. 定義を追加をクリックします。名前を付け、コンテンツタイプを選択して、保存します。
4. Shopifyのspring 26 Editionの時点で、設定に最初に移動することなく、顧客、注文、およびコレクションページから直接メタフィールドを作成することもできます。
5. 任意の製品(または他のリソース)を開き、メタフィールドセクションまでスクロールして値を入力します。

spring 26では、製品、顧客、および注文セクション上に最大50個のメタフィールドをピン留め

GraphQL Admin API経由

一括操作または自動化されたパイプラインの場合、metafieldDefinitionCreate(スキーマを作成する)の後にmetafieldsSet(値を記述する)を使用します。metafieldsSetミューテーションは、呼び出しあたり最大25個のメタフィールドを許可し、最大総要求ペイロードサイズは10 MBであり、操作はアトミックです。エラーが発生した場合、変更は保持されません。

最小限の定義ミューテーションは次のようになります。

mutation CreateMetafieldDefinition($definition: MetafieldDefinitionInput!) {
  metafieldDefinitionCreate(definition: $definition) {
    createdDefinition {
      id
      namespace
    }
    userErrors {
      field
      message
    }
  }
}

変数では以下のようになります。

{
  "definition": {
    "name": "Material",
    "namespace": "custom",
    "key": "material",
    "type": "list.single_line_text_field",
    "ownerType": "PRODUCT",
    "useAsCollectionCondition": true
  }
}

useAsCollectionCondition: trueを設定すると、追加ステップなしで、このフィールドを使用してスマートコレクションルールを強化できることを意味します。

一括カタログ更新の場合、Matrixifyなどのツールを使用すると、APIコードを記述することなくCSVからメタフィールド値をインポートできます。

ストアフロントでメタフィールドを表示する

ここは、ほとんどのマーチャントが立ち往生する場所です。定義を作成してもストアフロントにはフィールドが表示されません。それを接続する必要があります。

オプション1: テーマエディタの動的ソース(コードなし)

Online Store 2.0互換テーマ(Dawn、Horizon、またはJSONテンプレートテーマ)を使用している場合、テーマエディタを開き、動的ソースをサポートするセクションまたはブロックを追加またはクリックし、動的ソースを接続アイコンをクリックします。このように単一のテンプレートに最大20個のメタフィールドを追加できます。

オプション2: Liquid(完全な制御)

Liquid構文は以下のとおりです。

{{ product.metafields.namespace.key }}

リッチテキストメタフィールドの場合、metafield_tagフィルタを使用してHTMLフォーマットを正しくレンダリングします。

{{ product.metafields.custom.care_instructions | metafield_tag }}

画像ファイル参照の場合は、

{{ product.metafields.custom.hero_image.value | image_url: width: 800 | image_tag }}

1つの落とし穴: メタフィールドキーがsize、first、またはlastの場合、ドット表記ではなく角括弧表記を使用してください。product.metafields.namespace["size"]です。これらの単語は、組み込みのLiquidフィルタでもあり、キーが見つからない場合、ドット表記はメタフィールドをフェッチするのではなくフィルタを適用します。

5つの最高の影響力を持つ製品ページのユースケース(カスタムコンテンツタブ、製品バッジ、仕様テーブル、ダウンロード可能なPDF、関連製品リスト)それぞれは、独自の定義と、テーマのsections/main-product.liquid内の一致するLiquidブロックが必要です。

2026年の変更: 重要な更新

spring 26(2026年中旬に発表):

• カートメタフィールドが注文に引き継がれます。注文メタフィールド定義でcartToOrderCopyableを有効にすると、チェックアウトからのカートメタフィールド値が結果の注文に自動的にコピーされます。これはShopify Flow内の購入後ロジックの大きなロック解除です。
• リソースページを離れることなくメタフィールドを作成します。新しい定義を追加するために、設定 > カスタムデータに移動する必要がなくなりました。任意の顧客、注文、またはコレクションレコードからインラインで実行できます。
• 製品、顧客、および注文adminページに最大50個のメタフィールドをピン留めします。
• ShopifyQLドット構文フィルタリング。メタフィールドは、Analytics APIおよびオンラインエディタを通じて利用可能なドット構文を使用してShopifyQLの寸法およびフィルタとしてサポートされるようになりました。つまり、定義した任意のカスタムフィールドで分析レポートをセグメント化できます。
• 簡略化されたGraphQL API。spring 26 editionは、メタフィールドとメタオブジェクトの簡略化された読み取り/書き込みインターフェースで出荷され、アプリコードのボイラープレートを削減します。
• ショップユーザーメタフィールドはチェックアウト中に読み取り可能です。Shopify Functionsを使用して、保存された顧客データに対してバイヤー固有のチェックアウト別注をビルドできます。

Admin GraphQL API 2026-07(2026年7月の時点でリリース候補):

• 在庫転送のメタフィールド。別のmetafieldsSet呼び出しなしで、在庫転送にメタフィールドを直接定義および設定できるようになりました。

Winter 26:

• メタフィールドとメタオブジェクトはストアフロント上でより高速にレンダリングされ、より豊富なクエリフィルタリングをサポートし、以前のAPIバージョンよりも高い入力制限を許可します。

2025年10月(API 2025-10):

• article_referenceとlist.article_referenceタイプを追加しました。これにより、マーチャントは正式な製品から記事へのリンクを作成し、コンテンツドリブンSEOおよび編集コマースフローを実現できます。

メタフィールド対メタオブジェクト: どちらをいつ使用するか

メタフィールドは既存のリソースに単一のデータを保存します。メタオブジェクトは、独自のスキーマ、複数のフィールド、および独自のadmin UIを備えた再利用可能なスタンドアロンコンテンツエントリです。データが特定の製品(または注文、または顧客)に属し、それにのみ意味がある場合、メタフィールドを使用してください。共有されたサイズガイド、ブランドストーリ、またはサプライヤープロファイルなど、複数の製品に再利用されるコンテンツの場合、メタオブジェクトを使用してください。

2つをmetaobject_referenceメタフィールドで接続します。製品上のフィールドがメタオブジェクトエントリを指し、エントリを更新すると、それを参照しているすべての製品が自動的に更新されます。

メタフィールドとAIショッピングレイヤー

これは、ほとんどのマーチャントが2026年に見落としている角度です。ShopifyのSummer 26「Everywhere Edition」は、Universal Commerce Protocol(UCP)をすべてのストアでデフォルトで有効にしました。これにより、AIショッピングエージェントはカタログを読むことができます。メタフィールド内の構造化データ(仕様、成分、認定資格、材料)は、AIエージェントとGoogleのリッチ結果パーサーが製品をサーフェスするかどうかを判断するときに消費するものです。

カテゴリメタフィールドはここで特に注意が必要です。これらは、特定の製品カテゴリにマップされ、サイト、マーケットプレイス、検索エンジン上での製品の発見性を向上させるのに役立つ製品属性です。Shopify内に正しい製品カテゴリを割り当てると、デフォルトのカテゴリメタフィールドエントリが事前に入力されます(たとえば、Shirtカテゴリはサイズ、ネックライン、袖丈、生地、性別、および色のフィールドを提供します)。それらを一貫して入力すると、すべてのダウンストリームチャネルに同時に構造化データをフィードしています。

読みやすさのために製品の説明を個別のメタフィールドに分割した場合、現在、複数のShopifyフィールドを単一のShopifyカタログ説明フィールドにマップすることはできないことに注意してください。回避策は、説明とキーメタフィールドデータを連結した結合メタフィールドを作成し、その単一フィールドをカタログにマップすることです。

ガバナンス: ほとんどのチームがスキップする部分

メタフィールドは作成が簡単で、非常にスプロール化しやすいです。後で高価なクリーンアップを防ぐいくつかのルール。

• スキーマを文書化してください。すべてのネームスペース、キー、型、オーナーリソース、および定義を所有するアプリまたはチームを記録する参照シート(単純なスプレッドシートで十分)を維持してください。
• 標準定義が存在する場合は常にそれを使用してください。それらは相互運用可能で、自動検証され、命名の衝突に対して免疫があります。
• ライブデータを取得した後、タイプは変更しないでください。例えば、date_timeからmoneyへの移行により、すべての既存の値が無効になります。型を正しく事前に計画してください。
• ネームスペースのしきたり。アプリまたはチームごとに異なるネームスペース(logistics、marketing、compliance)を使用して、関連のないフィールドに影響を与えることなくネームスペース別に監査およびクリーンアップできるようにしてください。
• アトミック操作として書き込みをテストしてください。metafieldsSetミューテーションはアトミックです。1つの呼び出し内のすべての25個の値が成功するか、まったく成功しません。このガラントの周りに一括インポートを構成してください。

複雑なカタログのメタフィールドスキーマのアーキテクト化またはカスタムストアフロントへのメタフィールドの統合に関するヘルプが必要な場合は、Shopify開発者サービスページまたはShopifyテーマ開発者の仕事を参照してください。

クイックリファレンス: Liquid構文チートシート

メタフィールドは、2時間の基本的な学習が後で数週間の回避策を節約する機能の1つです。スキーマを慎重に定義し、標準定義を存在する場所で使用し、フィールドをストアフロントと分析レイヤーの両方に接続してください。2026の更新、特にカートから注文へのコピーとShopifyQLフィルタリング、メタフィールドデータがこれまで以上に実行可能であることを意味しています。