開発者向けの変更です。
対象は、Storefront API でマーケットのメタフィールドを読むアプリとカスタムストアフロント。
2027-01 から、Market.metafields はキーの大文字と小文字を区別しません
Storefront API の 2027-01 からの変更です。
2027-01 の Market.metafields は、大文字と小文字の違いを問わずにキーを照合します。
発表は2026年11月13日の developer changelog です。
出典: Shopify developer changelog「Market.metafields matches keys in any case as of Storefront API version 2027-01」2026年11月13日
https://shopify.dev/changelog/posts/market-metafields-matches-keys-in-any-case-as-of-storefront-api-version-2027-01
フラグは次の2つです。
- Breaking API Change
- Action required
タグは「Storefront API」です。
As of Storefront API version 2027-01, the metafields field on the Market object matches each requested key in any case, as Market.metafield already does.
(Storefront API のバージョン 2027-01 から、Market オブジェクトの metafields フィールドは、Market.metafield がすでにそうしているように、求められた各キーを大文字と小文字を問わずに照合します)
単数形の Market.metafield は、もとから大文字と小文字を区別しない作り。
複数形の Market.metafields が、それにそろう形です。
2026-10 までの Market.metafields は、大文字と小文字がそろわないと null を返します
2026-10 以前の Market.metafields は、キーの大文字と小文字の一致を求めます。
求めたキーと保存されたキーで大文字と小文字が違うと、値が返りません。
公式の例は、名前空間 custom・キー colour のメタフィールドです。
In version 2026-10 and earlier, the entry for { namespace: “custom”, key: “Colour” } is null.
In version 2027-01, the entry returns the stored metafield.
(バージョン 2026-10 以前では、namespace が custom・key が Colour の項目は null です。バージョン 2027-01 では、保存されたメタフィールドが返ります)
例で null になるのは、頭が大文字の Colour で求めた場合。
2027-01 では、同じ求め方で保存された値が返ります。
影響するのは、2つの条件のどちらかに当たるアプリです
公式は、影響する条件を2つ挙げています。
It requests a key in a different case from the key that the market stores.
The buyer’s markets store the same key in different cases.
(マーケットが保存するキーと違う大文字と小文字でキーを求めている。購入者のマーケットが、同じキーを違う大文字と小文字で保存している)
対象のクエリは、次の2つを満たすものです。
- Localization.market か Country.market から、Market のメタフィールドを読む
- Storefront API のバージョンが 2027-01 以降
Market.metafield だけを使うアプリは対象外です
キーを保存されたとおりの大文字と小文字で求めるアプリも、影響を受けません。
Your app isn’t affected if it requests each key in the case that the markets store it, or if it uses only Market.metafield, which already matches keys in any case. Versions 2026-10 and earlier don’t change.
(各キーをマーケットが保存したとおりの大文字と小文字で求めるアプリや、すでに大文字と小文字を問わずに照合する Market.metafield だけを使うアプリは影響を受けません。バージョン 2026-10 以前は変わりません)
2026-10 以前のバージョンの動きは、そのまま。
2つのフィールドを比べると、影響の有無を見分けられます
公式は、今のバージョンで Market.metafield と Market.metafields を比べる方法を示しています。
So on the version that you use today, Market.metafield returns the result that Market.metafields returns in 2027-01. You can compare the two fields to find out whether the change affects your app.
(そのため、今使っているバージョンでも、Market.metafield は 2027-01 の Market.metafields と同じ結果を返します。2つのフィールドを比べれば、変更がアプリに影響するかを見分けられます)
比べ方は、アプリが読むマーケットのメタフィールドごとに、同じ名前空間とキーで2つを求める形。
結果が全て同じなら、変更は要りません。
違いがあり、アプリやストアフロントに大きく響く場合の対応も示されています。
アプリとメタフィールドを、キーの大文字と小文字に頼らない形に直すよう公式は勧めています。
For example, request each key in the case that your markets store it, and use one case for each key on every market.
(たとえば、各キーをマーケットが保存したとおりの大文字と小文字で求め、どのマーケットでも各キーの大文字と小文字を1通りにそろえます)
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- Storefront API 2027-01 の公開日や、2026-10 の提供が終わる日は、この一次ソースには書かれていません
- 同じだけ具体的なマーケット同士で、大文字と小文字だけが違う同じキーを保存しているときの扱いは書かれていません。2027-01 では両フィールドが同じメタフィールドを返し、Market.metafield は購入者の最も具体的なマーケットのものを返す、とあります
- 店の側で何か操作が要るかは書かれていません。対象として書かれているのはアプリとカスタムストアフロントです
- Liquid や Function API に同じ変更があるかは書かれていません。タグは Storefront API だけです
- 🔴 本記事は一次ソースの「Related docs」の文書を読んでいません。クエリも実際には送っていません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の3つです。
- Storefront API で Market.metafields を使っているクエリを洗い出す
- 今のバージョンで、同じ名前空間とキーに Market.metafield と Market.metafields を当て、結果を比べる
- 結果が違うキーは、2027-01 に移る前に、保存されたとおりの大文字と小文字で求めるように直す
店がやることは次の1つです。
- カスタムストアフロントやアプリを作ってもらっている店は、マーケットのメタフィールドの大文字と小文字をそろえる予定を作り手に聞く
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Market.metafields matches keys in any case as of Storefront API version 2027-01」2026年11月13日
https://shopify.dev/changelog/posts/market-metafields-matches-keys-in-any-case-as-of-storefront-api-version-2027-01
上記の Shopify 公式の情報だけを一次情報として使っています。

