Shopifyのメタフィールド定義数の上限は256か128か250か｜公式ドキュメント3か所が食い違っている件と、カスタムデータアプリが要る境界線

この記事でわかること

先に結論数値の上限を一次情報で並べる定義数値のサイズ list型の要素数メタオブジェクト

この記事の目次Contents閉じる開く

商品ごとに素材、原産国、サイズ表、認証マーク。Shopifyのメタフィールドを使い始めると、最初は快適です。問題が出るのは、定義が増えてきたときと、まとめて更新したくなったときです。

「定義はいくつまで作れるのか」を調べようとすると、いきなり壁に当たります。Shopify公式ドキュメントの3か所が、それぞれ違う数字を書いているからです。

shopify.devの「Metafield limits」→ リソースタイプあたり 256
shopify.devの「Manage metafield definitions」→ owner typeあたり 128
help.shopify.comの「Adding metafield definitions」→ 250

3つ目に至っては、リソースあたりなのかストア全体なのかの単位すら書かれていません。

この記事では、公式に確認できる上限をすべて洗い出し、標準機能で運用が破綻する境界線を引きます。そのうえで、カスタムデータ管理アプリを課金単位で比較します。調査日は2026年9月1日です。

先に結論

**定義数の上限は公式に確定できません。**3つの値が併存しているため、設計上は最も厳しい250を安全側の基準とし、それを超える要件が見えた時点で構成を見直すのが現実的です。

**プラン別の差があるのはメタオブジェクト定義数だけです。**Basic・Shopify・Advancedが128、Plus・Enterpriseが256。メタフィールド側にはプラン別の表そのものが存在しません。

**CSVで扱えるメタフィールド型は26種だけです。**Shopifyのメタフィールド型は測定単位系46種とリファレンス型12種があるのに対し、商品CSVが対応するのは26種。json、rich_text_field、file_reference、rating は含まれません。

バリアントのメタフィールドはCSV完全非対応です。「Variant metafields aren't supported for product CSV import/export」と明記されています。ここがアプリ導入の最も明確な技術的境界線です。

**Shopifyが自ら「アプリを使え」と案内している領域があります。**ブログ記事・ページ・URLリダイレクトの一括編集は標準機能から削除され、ヘルプセンターがサードパーティアプリを名指しで案内しています。

数値の上限を一次情報で並べる

定義数

対象	上限	出典
メタフィールド定義（アプリ）	リソースタイプあたり256	shopify.dev「Metafield limits」
メタフィールド定義（マーチャント）	リソースタイプあたり256	同上
メタフィールド定義（TOML宣言型）	owner typeあたり128	shopify.dev「Manage metafield definitions」
メタフィールド定義（管理画面）	250	help.shopify.com
ピン留め定義	リソースタイプあたり50	shopify.dev

128はTOML（shopify.app.toml）で宣言するapp-owned定義に対するapp-scopedな制約として書かれているため、256とは適用範囲が違う可能性があります。ただし両ページとも「per owner/resource type」と書いており、整合していません。

なお標準メタフィールド定義は上限にカウントされません（「Standard metafield definitions don't count towards limits unless specified」）。

値のサイズ

ほとんどの型は**64KB（65,536バイト）**が上限です。例外は次のとおり。

型	上限
`id`	2KB
`json`	128KB
`url`	2KB

JSON型については、期限つきの記載があります。

Apps using JSON fields before April 1, 2026 will be grandfathered at the current 2MB limit.

つまりJSON型の上限は2MBから128KBに引き下げられ、2026年4月1日以前から使っていたアプリだけが2MBを維持しています。2026年9月時点で新規に組む場合は128KB前提です。

もうひとつ、公式ドキュメントに「Caution」として書かれている落とし穴があります。

Shopify Functions input queries don't return metafield values larger than 10,000 bytes. The value is still stored, and the GraphQL Admin API still returns it, but a function receives null for it.

**保存はできる。Admin APIも返す。でもFunctionからは null に見える。**配送カスタマイズや割引Functionでメタフィールドを参照する設計をしていると、原因の分からない不具合になります。

list型の要素数

すべてのlist型は最大128要素です。ただし例外がひとつあり、list.metaobject_reference だけは1024要素まで対応します。各要素のサイズ上限は、対応する単体型と同じです。

メタオブジェクト

ここだけプラン別の差があります。

プラン	メタオブジェクト定義数の上限
Basic	128
Shopify	128
Advanced	128
Plus	256
Enterprise	256

（公式表の表記が旧プラン名の「Shopify」のままである点は、そのまま引用しています）

1定義あたりのエントリー数は1,000,000件まで。フィールド数は「Metaobject limits」ページが40、TOML宣言型のapp-scoped制約が64と、ここでも数字が割れています。app側が一般より緩くなることは通常ないため、実務では40を設計上限と考えるのが安全です。

**メタフィールド定義数にはプラン別の表が存在しません。**Plusにアップグレードしてもメタフィールド定義数が増えるという公式記述はない、ということです。

管理画面のオプションにも上限がある

オプション	上限
商品インデックスのフィルタに使う	50定義
注文インデックスのフィルタに使う	5定義
企業・企業拠点インデックスのフィルタに使う	50定義
スマートコレクションに使う	128定義
メタオブジェクトインデックスのフィルタに使う	50定義

注文の5が特に厳しいので、注文メタフィールドで絞り込みたい要件がある場合は先に確認してください。

変更できない項目を先に押さえる

メタフィールド定義を作るときに、あとから直せない項目があります。

Type — 変更不可
Namespace / key — immutable
Owner type — 移行不可

更新できるのは Name、Description、Validations、Access だけです。namespace/keyを変えるには、新しい定義を作って値をコピーし、参照を更新して旧定義を削除する、という手動移行が必要になります。命名規則は最初に決めきってください。

さらに、TOMLでは設定できないcapabilityがあります。

Capability	TOMLで設定可能か
Smart collections	不可
Admin filterable	可
Unique values	可
Cart to order copyable	可
Analytics queryable	不可（サイレント失敗）
Pinning	不可

Analytics queryableについては、公式にこう書かれています。「shopify.app.toml accepts capabilities.analytics_queryable, and your app deploys without an error, but the capability isn't set」。エラーが出ないのに設定されません。metafieldDefinitionCreate / metafieldDefinitionUpdate ミューテーションでしか設定できません。

Liquidでの参照条件は、公式内で記述が矛盾している

テーマ実装で必ず当たる論点です。ストアフロントアクセス設定が、Liquidからの参照に必要なのかどうか。

shopify.devはこう書いています。

storefront controls permissions for the Storefront API (used by headless and custom storefronts). This setting doesn't affect Liquid templates - metafields are always accessible in Liquid regardless of this setting.

一方、help.shopify.comはこうです。

Storefronts access … Allows you to use the metafield in your Online Store either through Liquid or the Storefront API.

正反対に読めます。デフォルトがOFF（access.storefront = "none" / storefront: NONE）である点は両者一致していますが、Liquidへの影響については確定できません。実装前に自ストアで検証してください。

なお、古い記事でよく見る visibleToStorefrontApi というフィールドは、現行のGraphQL Admin APIとREST Admin APIのドキュメントで確認できませんでした。現行の制御は定義側の access.storefront です。REST Admin API自体が2024年10月1日にレガシー扱いとなり、2025年4月1日以降の新規公開アプリはGraphQL Admin APIのみで構築することとされています。

標準の一括編集とCSVで、どこまで届くか

管理画面の一括編集

商品、バリアント、コレクション、顧客のメタフィールドを一括編集できます。Products で対象を選び、Edit products → Columns からメタフィールド列を追加する流れです。

**一度に何件まで編集できるかは、公式に記載がありません。**代わりに「The more information you try to bulk change at one time, the longer your bulk changes will take」という記述と、次の注意書きがあります。

If you use the Microsoft Edge web browser to edit product metafields in bulk, then it can cause errors due a limited URL length.

URL長に依存する実装であることが示唆されていますが、具体的な件数は非公開です。

もうひとつ、実務で刺さるエラー挙動があります。「Update the invalid values, then save again」というエラーは、画面に表示していない列のバリデーションエラーでも発生します。定義数が多いストアでは、先にメタフィールド一括編集ツール側でエラーを潰したほうが早い、と公式も案内しています。

CSVで扱える型は26種だけ

商品CSVがサポートするメタフィールド型は、公式に限定列挙されています。

boolean, color, date, date_time, dimension, list.color, list.date, list.date_time, list.dimension, list.metaobject_reference, list.number_decimal, list.number_integer, list.product_reference, list.url, list.volume, list.weight, money, multi_line_text_field, number_decimal, number_integer, product_reference, shopify.disclosure, single_line_text_field, url, volume, weight

この26種に含まれない主要な型を挙げます。

json / rich_text_field / file_reference / rating / id / link / language / 単体の metaobject_reference / page_reference / collection_reference / variant_reference / customer_reference / company_reference / order_reference / article_reference / mixed_reference、および area duration frequency power pressure speed temperature などの測定単位型の大半。

リッチテキストの説明文、画像やPDFへの参照、評価値。いずれもCSVでは往復できません。

そして決定的なのがこれです。

Variant metafields aren't supported for product CSV import/export. To edit your variant metafields in bulk, you need to use the variant bulk editor, and then add metafield columns.

**バリアントのメタフィールドはCSV完全非対応です。**サイズ別・カラー別に固有のデータを持たせる設計をしている場合、標準のCSVでは一切扱えません。

列ヘッダの形式は <name> (product.metafields.<namespace>.<key>)、または product.metafields.<namespace>.<key> だけでも受け付けます。

なおメタオブジェクトの定義・エントリー自体をCSVで入出力する標準機能は、公式記載を確認できませんでした。商品CSVの list.metaobject_reference で参照を扱えるだけです。

Shopifyが公式にアプリを案内している領域

help.shopify.comの一括編集ページの冒頭に、次の記載があります。

The bulk editing feature for blog posts, pages, and URL redirects is no longer available.

そのうえでサードパーティアプリへのリンクが掲載されています。「アプリが必要になる境界線」として、これ以上ない一次情報です。この領域の詳細はShopifyの一括編集とCSVの制約を扱った記事で整理しています。

カスタムデータアプリを課金単位で比較する

3本ともBuilt for Shopifyバッジを取得しています。つまりバッジは選定基準になりません。差がつくのは課金単位です。

	Metafields Guru	Accentuate Custom Fields (ACF)	Matrixify
App Store URL	/metafields-editor-2	/accentuate	/excel-export-import
評価／レビュー数	5.0／219件	4.8／156件	4.9／1,444件
Built for Shopify	あり	あり	あり
課金単位	定額＋リソース数上限＋操作従量	完全定額	定額＋1ファイル件数
無料プラン	Free to install＋従量	あり（実質テーマブロックのみ）	あり（各10件）
有料の起点	$9／月	$25／月	$20／月
最上位	$59／月	$50／月	$200／月
メタオブジェクト対応	あり	あり	あり（プランで10／50／500／∞）
Languages欄に日本語	なし	あり	なし

（2026年9月1日にShopify App Storeで取得）

比較表から読み取れることは3つあります。

第一に、**課金の連動先がまったく違います。**Accentuateは完全定額で、商品数にも操作回数にも連動しません。Metafields Guruは定額に加えてリソース数の上限（2K／20K／100K）があり、超過分は「app credits」の従量課金（$1／1,000クレジット）です。Matrixifyは1ファイルあたりの処理件数で階層化されています。

第二に、無料枠の設計思想がそれぞれ違います。Metafields GuruのROOKIEは「Free to install」で、全メタフィールド型に対応し、メタオブジェクトエディタも使え、1,000クレジット分の一括操作が付いてきます（超過分は$1／1,000クレジットの従量課金です）。一方Accentuateの無料プランに含まれるのはプリメイドのテーマブロックだけで、一括編集も入出力もバージョン管理も含まれません。メタフィールド管理目的なら実質$25/月からです。Matrixifyの無料プランは各リソース10件までで、実データでの検証には足りません。

第三に、**メタオブジェクトを本格運用するとMatrixifyのプランが跳ねます。**Demoが10件、Basic($20)が50件、Big($50)が500件、Enterprise($200)が無制限。メタフィールドは全プランで無制限なのに、メタオブジェクトだけ極端に段階化されています。メタオブジェクトでコンテンツを管理し始めたストアには、これが決定的な選定要因になります。

Metafields Guru

256 Developmentが提供。レビュー219件で5.0、★3以下のレビューが1件もありません（★5が216件、★4が3件）。

料金は ROOKIE／ADEPT $9／GURU $19／GURU PLUS $59。ROOKIEは月額固定費のない「Free to install」で、全メタフィールド型に対応し、メタオブジェクトエディタ、テキストメタフィールド向けのWYSIWYGエディタ、1,000クレジット分の一括操作が使えます。**ただし完全無料ではありません。**1,000クレジットを超えた一括操作は $1／1,000 app credits の従量課金になり、この従量課金は上位プランでも上限超過分に適用されます。有料になるとExcel風エディタ、テーマ拡張ブロック、ブラウザ拡張、メタフィールドセット・定義、Shopify Flow連携、無制限の一括編集・入出力が解禁されます。

特徴的なのはブラウザ拡張です。「Use browser extension to manage metafields directly in the Shopify admin panel」と記載されており、管理画面の商品ページ上で直接メタフィールドを編集できます。2022年3月14日のレビュー（Roff Milling、南アフリカ）では「ブラウザ拡張が便利。ブログとページでも使えるようになるとさらに良い」という要望が出ています。

Languages欄はEnglishのみで、日本語UIはありません。

Accentuate Custom Fields (ACF)

Accentuate Digitalが提供。公式サイトのフッターに「Powered by Shop Circle」とあり、買収系アプリです。レビュー156件で4.8。

3本の中で唯一、Languages欄に日本語を含みます（他に20言語）。日本語UIを重視するなら、選択肢は実質これ1本です。

料金はFree／Professional $25／Professional Plus $50の3段階で、完全な定額制です。商品数にも操作回数にも連動しないため、大規模カタログでコストが読めるのが最大の差別化点です。

Professionalで一括編集、無制限の入出力、フィルタ・グルーピング、リファレンスマネージャー、複数ストアの連携が解禁。Professional Plusではさらにwebhookと、90日間の編集履歴の閲覧と復元、メタオブジェクト・メタフィールドのバージョン管理が付きます。画像のリサイズ・クロップやExcel経由のストア間データ転送も掲載されています。

注意点が2つあります。ひとつは無料プランの実用性です。含まれるのはプリメイドのテーマブロック（商品プロモーション、SEOキーワード、カウントダウンタイマー、プロモバナーなど）だけで、メタフィールド管理機能は入っていません。2026年1月24日のレビュー（atvs-vape、ポーランド、利用14分）は「無料プランを選ぶと何も使えないのはなぜか」という内容です。

もうひとつは課金運用の履歴です。2023年12月12日のレビューでは、年額を購入した6か月後に値上げに伴う再課金を求められ、支払うまでアクセスを遮断されたと報告されています。買収系アプリの価格改定リスクとして、頭に入れておく価値があります。

Matrixify

一括入出力の総合ツールで、レビュー1,444件と実績は3本の中で最大です。メタフィールドは全プランで無制限に扱えます。

**この記事の文脈で見るべきはメタオブジェクトの上限です。**Demoが1ファイル10件、Basic($20)が50件、Big($50)が500件、Enterprise($200)が無制限。メタオブジェクトでFAQ、店舗情報、レシピといったコンテンツを管理し始めると、数百件はすぐに超えます。

一括入出力全般の比較は別記事で扱っているので、ここでは繰り返しません。ひとつだけ補足すると、2026年5月7日のレビュー（Weston Nurseries、米国、利用約2年）では「APIアクセススコープが3つ追加されたが事前通知がなく、ストアオーナーが設定を更新するまでアプリが使えなくなった」と報告されています。アプリのスコープ追加は業務停止につながりうるので、権限承認の担当者を決めておくことをおすすめします。

ケース別の選び方

定義が50個以下、商品も数百点

標準機能で足ります。管理画面の一括編集とCSVで回せる範囲です。ただしバリアントのメタフィールドを使うなら、CSVでは往復できない点だけ確認してください。

日本語UIで運用したい

Accentuate Custom Fields (ACF)が唯一の選択肢です。ただしメタフィールド管理機能はProfessional($25)からで、無料プランには含まれません。

商品10万点、メタフィールド編集は月1回程度

Accentuate Professional($25)が最安になります。完全定額なので、カタログ規模でコストが動きません。

商品2,000点、毎日インポートを回す

Metafields Guru ADEPT($9)が候補です。2Kリソースの上限内なら定額で収まります。超過分は$1/1,000クレジットの従量です。

メタオブジェクトを500件以上、一括で管理したい

Matrixify Big($50)以上が必要です。Basic($20)は1ファイル50件までなので足りません。

`json` や `rich_text_field` を一括更新したい

標準CSVでは扱えないため、アプリが必要です。3本とも対応型としてJSONとテキストを掲載しています。

バリアント単位のメタフィールドを一括編集したい

管理画面のバリアント一括編集ツールを使うか、アプリを使ってください。商品CSVでは不可能です。

導入前チェックリスト

作りたい定義数が250以内に収まるか（公式が矛盾しているため最も厳しい値で見る）
メタオブジェクト定義が128を超えないか（超えるならPlusが必要）
注文メタフィールドでフィルタしたい定義が5個以内か
namespace / key の命名規則を確定したか（あとから変更できない）
バリアントのメタフィールドを使うか（使うならCSVでは扱えない）
json 型の値が128KBに収まるか（2026年4月1日以降の新規は128KB）
Shopify Functionsから参照する値が10,000バイト以内か
Liquidでの参照に、ストアフロントアクセスの検証を済ませたか
アプリの課金単位が定額か、リソース数か、1ファイル件数か
設定を担当するメンバーが使える言語のUIか

まとめ

判断の順序は4つです。

**1. 上限は公式に確定できないという前提で設計する。**メタフィールド定義数は256・128・250の3つが公式内に併存しています。最も厳しい250を基準にし、そこに近づいたら構成の見直しを検討してください。

**2. プラン差があるのはメタオブジェクトだけ。**Basic・Shopify・Advancedが128、Plus・Enterpriseが256です。メタフィールド側にプラン別の記載はありません。

**3. アプリが必要になる境界は「CSVで往復できるか」で引ける。**バリアントのメタフィールドと、26種に含まれない型。ここに該当するデータを一括で扱うなら、標準機能では回りません。

**4. アプリは課金単位で選ぶ。**Accentuateは完全定額、Metafields Guruはリソース数＋操作従量、Matrixifyは1ファイル件数です。同じ規模のストアでも、扱うデータの種類で最適解が入れ替わります。

料金・機能・レビュー件数は変更されます。導入前に、各アプリのShopify App Store掲載ページで最新の内容を確認してください。

参考

Shopifyの各バリエーションにはbarcodeフィールドがあり、bin location（棚番）もpick listも今や標準機能です。それでも標準にない画面がひとつだけあります。梱包台で商品をスキャンして、Shopifyが「この注文で合っている／違う」と答える瞬間です。Shopify POSのバーコードスキャンは、カートへの商品追加、検索、在庫転送の受け取りのために文書化されていて、オンライン注文の明細を検品するためのものではありません。2026年9月2日時点でUS App Storeの実在アプリ7本の料金を確認したところ、課金の分母が5種類に分かれていました。注文数、スキャナー台数、ユーザー数、フルフィルメント件数、そして定額です。月5,000件の出荷では、同じ作業がFulfil‑IT ‑ Scan & Packで14.99ドル、Pickware ERP & WMSで938ドルになります。