EC・Shopify読了約14分

Shopifyのメタオブジェクトとメタフィールドの違い|サイズ表で判断

複数商品で使い回すサイズ表はメタオブジェクト、商品1つだけの項目はメタフィールドが目安です。

記事の概要図

作業着や靴を扱う店で、商品ページごとにサイズ表を説明文へ貼っています。メーカーがサイズ表の寸法を1行直したとき、同じ表を使っている十数点の商品を1つずつ開いて直さなければならず、直し漏れで古い寸法が残る商品も出ます。外注先に相談すると「メタフィールドで持ちましょう」と言う人と、「メタオブジェクトにしましょう」と言う人がいて、違いが分からないまま見積もりを比べています。こんなことはないでしょうか。

この記事では、Shopifyのメタフィールドとメタオブジェクトの違いを、サイズ表という1つの題材で比べます。2026年11月16日にShopifyの開発者向け公式資料で確認した内容だけを書き、判断の分かれ目、定義の数や表示の上限、割引などの独自ロジックから読めるかどうか、見積もりで確認する項目を、記入例つきで整理します。コードは載せません。

この記事で分かること

結論から言うと、サイズ表のように複数の商品が同じ内容を見る情報はメタオブジェクト、商品1つにだけ付く項目はメタフィールドで持つのが目安です。2026年11月16日に確認したShopifyの開発者向け資料では、両者は組み合わせて使う前提で、商品のメタフィールドからメタオブジェクトの記録を参照します。

  • メタフィールドとメタオブジェクトの役割の違いと、サイズ表で使い分ける判断表
  • 定義の数、表示の件数、値の大きさなど、確認した上限
  • 外注先への確認項目と、記入例

1. 商品ごとのサイズ表で起きること

サイズ表は、使い回される情報の代表です。次のような状況になりがちです。

説明文にサイズ表を直接貼っている寸法の修正が、貼った商品の数だけ必要になる
商品ごとに別の欄へ入力している入力の揺れ(単位、表記)が商品ごとに出る
画像でサイズ表を貼っている修正は画像の作り直し。文字の検索や翻訳にも使いにくい

仮に、同じサイズ表を使う商品が15点あるとします。寸法を1行直すとき、直書きなら15回の編集が必要です。1つのサイズ表の記録を15商品が参照する作りなら、修正は1回です。サイズ表を使う商品が増えるほど、この差は広がります。

サイズ表を商品ごとに持つ場合と1つの記録を参照する場合の図

ここで考える必要があるのは、「サイズ表という記録を1つつくって、複数の商品から参照する」のか、「商品1つ1つに、サイズ表の項目を持たせる」のか、という点です。前者がメタオブジェクト、後者がメタフィールドの役割に近くなります。

2. メタフィールドとメタオブジェクトは、何が違うのか

メタフィールドは既存の資源に項目を足す仕組み、メタオブジェクトは独立した記録をつくる仕組みです。

Shopifyの開発者向け資料は、データベースにたとえて説明しています。

役割既存の資源(商品・顧客・注文など)に、項目を足す独立した新しい種類の記録をつくる
データベースでたとえると既存の表に列を足す新しい表をつくる
付く先商品、顧客、注文などの個別の資源どの資源にも付かず、複数の資源から参照される
1つの値の持ち方1つの値(または値のリスト)複数の関連する項目をまとめた1件の記録
例商品に「素材」という項目を足す「ワークジャケットA用サイズ表」という記録

資料は、メタオブジェクトを「複数の関連する項目を持つ構造」、メタフィールドを「既存の資源に1つの項目を足す手段」と書き分けています。また、サイズ表(size_chart)を、メタオブジェクトの定義の例として挙げています。

大事なのは、両者を競わせないことです。実際の設計では、組み合わせて使います。商品に「サイズ表」というメタフィールドを足し、その値に、メタオブジェクトのサイズ表の記録を指定します。資料は、こうした参照を行うための型として、メタオブジェクトへの参照(metaobject_reference)と、そのリスト版を挙げています。

3. サイズ表は、メタフィールドとメタオブジェクトのどちらで持つのか

複数の商品が同じ内容を見るなら、メタオブジェクトで持ちます。

資料にある分類の考え方を、自店のデータに当てはめる表にします。

商品1つにだけ付く属性メタフィールド素材、洗濯表示、組み立て時間
複数の商品で使い回す独立した情報メタオブジェクトサイズ表、産地の紹介、つくり手の紹介
関係そのものに情報が付く間に挟むメタオブジェクト商品と部品の組み合わせと、その必要数

この表に、自店の項目を埋めると、どちらに分けるかが見えてきます。次の3つの質問が、分かれ目になります。

質問1 同じ内容を、複数の商品が見るか。 見るなら、メタオブジェクトです。サイズ表は、型の近い商品が同じ表を見るため、典型です。

質問2 内容を直すとき、1か所の修正で全商品に反映したいか。 したいなら、メタオブジェクトです。直書きや商品ごとの入力は、反映が商品の数だけ必要になります。

質問3 複数の項目が1つのまとまりとして動くか。 動くなら、メタオブジェクトです。サイズ表は、サイズ名、胸囲、ウエスト、着丈が一緒に動きます。

3つとも「いいえ」なら、メタフィールドで足ります。たとえば、素材は商品ごとに違う1つの項目で、ほかの商品と共有しません。

資料は、関係を作るときに、ハンドルやIDを文字の欄に書いて結びつけることをすすめていません。理由として、関連するデータの結びつきが切れ、テーマやStorefront APIで効率よく取り出せなくなるためと書かれています。参照用の型を使うのが前提です。

メタフィールドで足りる場合

メタオブジェクトのほうが新しい仕組みに見えるため、何でも記録にしたくなりますが、足りる場面で増やすと、管理する定義が増えるだけです。次の表のように、商品1つに付く単純な項目は、メタフィールドのままで十分です。

素材(綿100%など)商品のメタフィールド商品ごとに値が違い、共有しない
洗濯表示の文章商品のメタフィールド1商品ずつの注意書きで、まとまりがない
組み立て時間(分)商品の数値のメタフィールド1つの数値で、参照されない
同梱物の一覧商品のリストのメタフィールド項目数が少なく、他と共有しない

目安として、「その項目を、ほかの商品が見に来ることがあるか」を考えます。見に来ないなら、メタフィールドです。迷う項目は、最初はメタフィールドで始めて、複数の商品に同じ内容が増えてきた時点で、メタオブジェクトへ切り出す方法もあります。ただし、切り出しには、既存の値の移し替えが必要になるため、最初から共有の見込みがはっきりしている項目(サイズ表、産地紹介)は、記録にしておくほうが、手戻りが少なくなります。

4. サイズ表の設計例

作業着の店で、サイズ表を記録にする例です。数字は記入例です。

表の名前1行の文章ワークジャケットA用必須にする
サイズ名1行の文章M行ごとに別の記録にするか、表全体を1件にするかを決める
胸囲長さ(dimension)100cm資料では、単位にcm、mm、inchesなどが選べる
着丈長さ(dimension)68cm同上
注意書き複数行の文章洗濯後に1〜2cm縮む場合があります商品ページに表示する

資料のサイズ表の例では、サイズ、胸囲、ウエスト、着丈をそれぞれ項目にして、サイズごとに1件の記録をつくっています。同じ作りで、記録を「サイズ1行につき1件」にする方法と、「表1枚につき1件」にして中に複数行を持たせる方法があります。

サイズ1行につき1件サイズ表の種類8×サイズ6=48件行ごとに在庫や別の情報が要る
表1枚につき1件サイズ表の種類8=8件表として一括で見せたい

48は8×6の計算です。件数は、資料に書かれた上限(1つの定義あたり最大1,000,000件)にはまったく届きません。設計で気にするのは、上限ではなく、修正のしやすさです。サイズ表を直す担当者が、管理画面でどの粒度で編集したいかに合わせます。

サイズ表の記録を作る順番にも、決まりがあります。最初に定義(項目の一覧と型)を作り、そのあとで記録を作ります。定義を作る段階で、項目の名前、型、必須かどうか、入力の制限(文字数の上限など)を決めます。資料は、定義を、記録の構造や規則を決める設計図と説明しています。定義を後から変えるほど、すでに入力した記録の直しが増えるため、最初の設計で、サイズの表記(Mか、メディアムか)と、単位(cmかinchesか)をそろえる規則を決めておきます。

商品側には、「サイズ表」というメタフィールドを足し、型をメタオブジェクトへの参照にします。商品ごとに、使うサイズ表を選ぶだけになります。複数の表を選ぶ必要がある(メンズとレディース)場合は、リスト版の参照を使います。

サイズ表の記録を商品が参照する設計の図

管理画面で作ったメタオブジェクト定義。サイズ名・胸囲・着丈の3項目

5. メタオブジェクトには、どんな上限があるのか

定義の数はプランで変わり、テーマで1ページに読み込める件数にも上限があります。

設計の前に、資料で確認した上限を押さえます。確認日は2026年11月16日です。

メタオブジェクトの定義数(アプリ)1つのアプリが、1店舗に128まで
メタオブジェクトの定義数(店側)Basic、Shopify、Advancedは128、Plus、Enterpriseは256
1定義あたりの項目数40まで
1定義あたりの記録の数1,000,000まで
メタフィールドの定義数1つの資源の種類につき256まで(アプリも店側も)
メタフィールドの値の大きさ全体で2MB。多くの型は64KB、jsonは128KB
リストの項目数128まで。ただしメタオブジェクトへの参照は1,024まで

読み取りのポイントは2つです。

1つ目は、定義数がプランで違うことです。プランを上げると、店側で作れる定義の数が256になります。小さな店のサイズ表や産地紹介の数なら、128でも足りることが多いと考えられます。

2つ目は、テーマで表示するときの上限です。資料は、ページ送りの指定なしでループすると、50件までしか返らず、指定ありだと1ページ250件までと書いています。1ページで読み込める同じ種類の記録は1,000件まで、記録の種類は50までです。この上限を超えると、記録の代わりにLiquidのエラーが出る、とも書かれています。たとえば、色の見本(スウォッチ)を1商品に何十件も持たせる設計は、この上限を意識します。

6. 使える範囲と使えない範囲

メタオブジェクトには、読み書きの権限と、追加の機能があります。

管理画面での編集権限の設定で、店側が編集できるようにできる
公開APIでの読み取り設定で公開にできる。テーマ(Liquid)では、この設定にかかわらず読める
下書きと公開公開状態の機能を有効にすると、DRAFTとACTIVEを切り替えられる
翻訳翻訳の機能を有効にすると、翻訳できる
ページとして表示オンラインストア用の機能を有効にすると、記録をWebページとして出せる
分析分析で読めるようにする機能がある
割引・配送などの独自ロジックアプリが所有する種類は、入力クエリから読める。店側が所有する種類は読めない

特に注意したいのが、最後の行です。サイズ表の内容を割引や配送の独自ロジックから使いたい場合、店側が所有する種類では使えません。独自ロジックの設計に使う設定値は、アプリが所有する種類にするのが前提です。サイズ表の表示だけなら、店側が所有する種類で足ります。

資料は、店側が所有する種類の作り方として、GraphQLを使う道筋を案内しています。ただ、開発ストアの管理画面では、設定のメタフィールドとメタオブジェクトから「定義を追加」で、店側の種類を作れました(検証したことの節を参照)。設定ファイルからは、アプリが所有する種類だけが作られます。「誰が作って、誰が編集するのか」で、所有の種類を決めます。

店側が所有サイズ表、産地紹介など、店の担当者が直す内容店の担当者(管理画面)
アプリが所有アプリの設定値、独自ロジックの入力アプリの管理者、権限の設定による

7. 移行と更新の運用

メタオブジェクトにしたあとの運用は、移すときと、直すときの2場面に分けて決めます。

移すときサイズ表の種類を洗い出し、記録を作る外注先が作成、商品担当が内容を確認種類ごとに、元の表と記録を並べて見る
移すとき商品に使うサイズ表を指定する外注先が一括で設定商品ごとに、表示されたサイズ表が正しいかを抜き取りで見る
移すとき説明文に貼った古い表を消す商品担当二重表示になっていないかを見る
直すとき寸法の修正商品担当修正後、参照する商品の1〜2点で表示を見る
直すとき新しいサイズ表の追加商品担当下書きで作り、確認後に公開する

下書きの機能は、確認した資料に書かれています。公開状態の機能を有効にすると、記録をDRAFTとACTIVEで切り替えられ、確認してから公開する運用ができます。新しいサイズ表を追加するときに、いきなり商品ページへ出さずに済みます。

もう1つ、翻訳の機能があります。多言語で売る店は、サイズ表の注意書きなど、文章の項目を翻訳できるように設定できるかどうかを、定義の段階で確認します。あとから設定を変える手間を避けるために、見積もりの段階で、多言語の予定があるかを外注先に伝えておきます。

移行のとき、元の表と記録の内容が一致しているかの確認は、必ず店側が行います。数字の写し間違いは、外注先からは見えないためです。種類が8、サイズが各6行なら、確認する数字は、胸囲と着丈の2項目を掛けて8×6×2=96か所です。1か所30秒で確認すると、96×30=2,880秒で48分かかります。この時間を、店側の作業として見込みます。

8. 見積もりで確認する項目

分け方の根拠どのデータをメタオブジェクトにするかサイズ表、産地紹介の2種類。素材は商品の項目
所有の種類店側かアプリか店側。独自ロジックでは使わない
項目の型数値や単位をどの型で持つか胸囲と着丈は長さの型(単位はcm)
参照の型商品とサイズ表を、どの型で結ぶかメタオブジェクトへの参照
既存データの移行説明文に貼ったサイズ表を誰が記録に移すか8種類を外注先が移行、確認は店側
テーマの改修表示のためのテーマの修正の範囲サイズ表の表示部分を新規追加
上限の確認1ページの表示件数が上限に近くないかサイズ1行ごと1件でも最大6件。問題なし
編集の運用誰が、どの画面で直すか商品担当が、管理画面のメタオブジェクトで直す

移行の作業は、見積もりで抜けやすい項目です。説明文に貼ったサイズ表を記録に直す作業は、サイズ表の種類数と、商品への結びつけの数で決まります。たとえば、サイズ表8種類と商品120点なら、記録の作成が8件、商品への指定が120点分です。ここを「テーマの改修」にまとめず、別の行にしてもらうと、費用が見えやすくなります。

見積もりで確認する項目の図

9. よくある失敗

失敗1 メタフィールドの文章欄に、サイズ表をそのまま入れる。 商品ごとに持つことになり、直しの手間が減りません。複数の商品で使う内容は、記録に分けます。

失敗2 参照ではなく、名前を文字で書いて結びつける。 名前の変更で結びつきが切れます。資料もこの方法をすすめていません。

失敗3 所有の種類を考えずに作る。 後から割引や配送の独自ロジックで使いたくなっても、店側が所有する種類は入力クエリで使えません。最初に、使う予定を確認します。

失敗4 上限を確認せずに大量の記録をテーマで並べる。 ループの件数や、1ページで読み込める件数に上限があります。

失敗5 誰が直すかを決めない。 メタオブジェクトにしても、直す担当者が決まっていなければ、古い寸法が残ります。編集の権限と担当者を、運用に含めます。

10. 最初の一歩

最初の一歩は、自店の商品ページの説明文から、複数の商品で同じ内容になっている部分を、3つ探すことです。サイズ表、産地や素材の説明、取り扱い上の注意などが候補です。見つけたら、第3章の3つの質問に答えます。1つでも「はい」なら、メタオブジェクトの候補です。

候補が決まったら、1種類だけ試しに記録にして、2〜3商品から参照してみます。商品ページでの見え方、管理画面での編集のしやすさを見てから、全体へ広げます。

検証したこと

2026年11月17日に、Shopifyの開発ストア(日本語の管理画面、Chrome)で、サイズ表をメタオブジェクトにして商品から参照するところまでを作りました。

  • 手順1: 設定の「メタフィールドとメタオブジェクト」から、メタオブジェクト定義「検証_サイズ表」を作り、項目を3つ(サイズ名=単一行テキスト、胸囲と着丈=寸法)にしました(1枚目の画像)。
  • 手順2: コンテンツのメタオブジェクトから、記録を1件(サイズM、胸囲1,000mm、着丈680mm)作りました。
  • 手順3: 商品のメタフィールド定義を作り、型をメタオブジェクト参照(「検証_サイズ表」)にしました(2枚目の画像)。商品「検証_オーダー棚」で、その項目にサイズMの記録を選びました。
  • 結果: 記録の画面の「参照」欄に、この記録を使っている商品が出ました(3枚目の画像)。1か所を直せば、参照している商品すべてに効く、という説明の根拠になる画面です。所要時間は記録していません。

商品のメタフィールド定義の画面。型にメタオブジェクト参照を選んだところ

記録の画面の参照欄に、使っている商品が出ている

うまくいかなかった所:

  • 日本語だけの項目名では、項目のキーが自動で作られず、「キーが短すぎます」というエラーで保存できませんでした。英字を項目名に足して解決しました。キーは英数字で決める前提で、設計表に書いておきます。
  • 管理画面の長さの型は、単位の初期値がmmでした。cmへの切り替えは試していません。

未検証のこと:

  • 参照している商品が1件だけの確認です。複数の商品から同じ記録を使って、1回の修正が全部に反映される動きまでは、確かめていません。
  • 定義数の上限(128、256)、テーマでの表示件数の上限、割引や配送の独自ロジックからの読み取りは、確かめていません。公式資料の記載のままです。
  • メタフィールド側に、サイズ表を直接持たせる形(商品ごとの入力)は、作っていません。

まとめ

  • メタフィールドは既存の資源に項目を足す仕組み、メタオブジェクトは独立した記録をつくって使い回す仕組みです。
  • 同じ内容を複数の商品が見る、1か所の修正で全体に反映したい、複数の項目が1つのまとまりで動く、のどれかに当てはまればメタオブジェクトです。
  • 定義の数はプランで変わります(店側はBasic、Shopify、Advancedが128、Plusが256)。テーマの表示件数の上限も確認します。
  • 割引や配送の独自ロジックから読むなら、アプリが所有する種類にする必要があります。

サイズ表や産地紹介の置き場所で迷ったら、既存の説明文の棚卸しから一緒に進められます。

よくある質問

メタオブジェクトとメタフィールドは、どちらを先に覚えればよいですか。

メタフィールドは、商品や注文などの既存のものに項目を足す仕組みです。メタオブジェクトは、サイズ表や産地紹介のような独立した記録をつくり、複数の商品から使い回す仕組みです。商品1つにだけ付く項目ならメタフィールド、複数の商品が同じ内容を見るならメタオブジェクトと考えると、迷いにくくなります。

メタオブジェクトは、Shopifyのどのプランでも使えますか。

2026年11月16日に確認した開発者向け資料には、メタオブジェクトの定義数がプランで変わると書かれています。Basic、Shopify、Advancedは128、Plusは256です。使えるかどうかではなく、作れる数の差として書かれています。

メタオブジェクトの内容を、割引や配送の独自ロジックから使えますか。

資料では、アプリが所有する種類のメタオブジェクトは、Shopify Functionsの入力クエリから読めると書かれています。一方、店側が所有する種類は、Functionsの入力クエリでは使えないと書かれています。独自ロジックから使う予定があるなら、所有の種類を最初に決める必要があります。

サイズ表をメタオブジェクトにすると、商品ページで1商品あたり何件まで表示できますか。

テーマでは、ループで表示できる件数に上限があります。資料では、ページ送りの指定なしで50件、指定ありで1ページ250件、1ページで読み込める同じ種類の記録は1,000件までと書かれています。サイズ表1枚を商品に結びつける使い方なら、この上限に近づくことは多くありません。

参照元・出典

FREE CONSULTATION

「うちの場合はどうか」から

記事の考え方を、そのままご自身の事業に当ててみたい方へ。アイデア段階でも、機能リストがある段階でも構いません。 2営業日以内に、担当者からメールでご返信します。営業のお電話はしません。相談は無料です。

運営:株式会社miitaso(会社概要)

RELATED