メタフィールドとは・定義の作り方
メタフィールド定義を作り、所有者・namespace.key・アクセス設定の意味を説明できる
最終確認: 2026-09
解説
受託の現場でなぜ必要か： この回では、メタフィールド（標準の項目に無いデータを商品などに足す仕組み）の定義を作り、所有者・namespace.key・アクセス設定の意味を説明できるようになります。
受託では、定義の型は後から変えられないので、命名と型を最初に決めて一覧を引き渡すところまでが仕事になります。
メタフィールドとは、標準に無いデータを足す入れ物
メタフィールドは、標準の項目に無いデータを商品などに持たせる仕組みです。
素材・産地・スペック・注意書きのような値を、商品ごとに保存できます。
保存した値は、テーマ・アプリ・APIのどこからでも同じように読めます。
どこに付けられるか（所有者）
メタフィールドを付ける先を所有者（owner）と呼びます。
商品・バリエーション・コレクション・顧客・注文・ドラフト注文が代表的な所有者です。
ページ・ブログ・記事・ロケーション・マーケット・会社・ショップにも付けられます。
定義は管理画面のカスタムデータ設定で、所有者ごとに作ります。
全一覧は管理画面か、APIのMetafieldOwnerTypeで確認します。
定義とは、入力欄と型のチェックを付けること
定義（definition）を作ると、編集画面に入力欄が現れ、型のチェックが効きます。
名前はnamespace.keyの形で付けます。
管理画面で作るときの既定のnamespaceはcustomで、アプリ用には予約された$appがあります。
命名はcustom.materialのように英小文字とアンダースコアで揃え、一覧をドキュメントにして引き渡します。
定義の型は後から変更できません（削除して作り直しになります）。
発展：定義なしのメタフィールドとアクセス設定
アプリが作る「定義なし」のメタフィールドもあり、Liquidからは定義ありと同じように読めます。
「ストアフロントアクセス」は、Storefront API（ヘッドレスなど、テーマ以外から読むための口）からの読み取りを許すかの設定です。
Liquidはこの設定に関係なく読めます。
管理画面で編集できるかどうかも、別に設定します。
※ ShopifyはShopify Inc.の商標です。本サイトは個人が制作した非公式の学習教材であり、同社の承認・提携・後援を受けていません。記載内容は2026-09時点のものです。料金・上限値・管理画面のラベルは変わるため、作業の前に公式ドキュメントで確認してください。