開発者向けの変更です。
マーケットが重なる店のテーマやアプリで、購入者に返る値が変わる場合がある話。
同じだけ具体的なマーケットが並ぶと、handle の順で値が決まります
並んだマーケットの中では、handle が最も小さいマーケットの値が返ります。
発表は2026年11月13日の developer changelog です。
出典: Shopify developer changelog「Market metafields break ties between equally specific markets by market handle」2026年11月13日
https://shopify.dev/changelog/posts/market-metafields-break-ties-between-equally-specific-markets-by-market-handle
フラグは「Update」。
タグは「Functions」「Liquid」「Metafields and metaobjects」「Storefront API」です。
When a buyer matches two or more equally specific markets that set the same metafield, Market.metafield and Market.metafields now return the value from the market with the lowest handle, instead of the value that was updated most recently.
(購入者が、同じメタフィールドを持つ同じだけ具体的な2つ以上のマーケットに当たるとき、Market.metafield と Market.metafields は、最後に更新された値ではなく、handle が最も小さいマーケットの値を返すようになります)
最も具体的なマーケットの値が使われる決まりは、今までどおり。
変わるのは、同じだけ具体的なマーケットが並んだときの決め方だけです。
これまでは、最後に更新された値が使われていました
変更の前は、並んだマーケットのうち最後に更新された値が勝っていました。
公式の例は、カナダの購入者が2つの地域マーケットに当たる場合です。
For example, a buyer in Canada matches two region markets: one for Canada and the United States, with the handle canada-us, and one for Canada and Mexico, with the handle canada-mexico.
(たとえばカナダの購入者が、2つの地域マーケットに当たるとします。1つはカナダと米国の handle canada-us、もう1つはカナダとメキシコの handle canada-mexico です)
After this change, the buyer gets the value from canada-mexico, because canada-mexico comes before canada-us.
(変更の後は、canada-mexico が canada-us より前に来るため、購入者には canada-mexico の値が返ります)
例で返るのは、canada-mexico の値。
handle の比べ方は、1文字ずつのバイト値の順です。
For handles that use only lowercase letters, digits, and hyphens, this is alphabetical order, with hyphens before digits and digits before letters.
(小文字・数字・ハイフンだけの handle では、アルファベット順になります。ハイフンが数字より前、数字が文字より前です)
対象は Storefront API・Liquid・Function API の全てのバージョンです
この変更は、API のバージョンを問わずに当てはまります。
This behavior change applies to the Storefront API, Liquid, and Function APIs on every API version.
(この動きの変更は、Storefront API・Liquid・Function API の全ての API バージョンに当てはまります)
- Storefront API: Market.metafield と Market.metafields
- Liquid: localization.market.metafields
- Function API: 入力にマーケットを含む各 Function API の Market.metafield
値が変わるのは、3つの条件がそろったときだけです
返る値が変わるのは、次の3つが全て当てはまる場合です。
The buyer matches two or more equally specific markets that set the same metafield.
No more specific market that the buyer matches sets that metafield.
The tied markets store different values, and the most recently updated value isn’t the value from the market with the lowest handle.
(購入者が、同じメタフィールドを持つ同じだけ具体的な2つ以上のマーケットに当たる。購入者が当たる、より具体的なマーケットがそのメタフィールドを持たない。並んだマーケットの値が違い、最後に更新された値が handle の最も小さいマーケットの値ではない)
マーケットが重ならない店はこの条件に入らない、というのはキクシル編集部の推測です。
影響しうる店には、Shopify が連絡するとしています
展開は、見える値が変わらない店から先に進みます。
Shopify is rolling out this change first to stores where the new tie break behavior doesn’t change which values buyers see. For stores that might be affected, Shopify will contact merchants so they can adjust market handles before the change applies to their store.
(Shopify はまず、新しい決め方で購入者に見える値が変わらない店から展開します。影響しうる店には、変更が当てはまる前にマーケットの handle を直せるよう、Shopify から店に連絡します)
理由として公式が挙げるのは、更新の時刻が管理画面に出ないことです。
The update time of a metafield isn’t visible in the Shopify admin. Merchants couldn’t see or control which value buyers got, and editing a metafield on one market could change what buyers in an overlapping market saw. Market handles are visible and editable in the Shopify admin, so merchants can choose which market wins a tie.
(メタフィールドの更新時刻は管理画面に出ません。店は購入者にどの値が返るかを見ることも決めることもできず、1つのマーケットでメタフィールドを直すと、重なるマーケットの購入者に見えるものまで変わることがありました。マーケットの handle は管理画面で見られて直せるので、店はどのマーケットが勝つかを選べます)
handle なら、店が管理画面で選べる仕組み。
アプリ開発者の対応は要らないと、公式は書いています
アプリのパートナーがやることについて、公式の記載は1行です。
No action is needed for app partners.
(アプリのパートナーの対応は不要です)
一方で公式は、マーケットが重なる店でメタフィールドを読むアプリやテーマに、並んだときの値を見るよう勧めています。
If your app or theme reads market metafields on stores with overlapping markets, check which value buyers get in a tie.
(マーケットが重なる店でマーケットのメタフィールドを読むアプリやテーマは、並んだときに購入者がどの値を受け取るかを見てください)
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 変更が全ての店に当てはまり終わる日は書かれていません
- Shopify からの連絡の手段と具体的な日付は書かれていません(変更が当てはまる前とだけあります)
- マーケットの handle を直したとき、ほかの設定や URL に影響があるかは書かれていません
- 大文字や日本語などを含む handle の並びの具体的な説明は書かれていません。比較はバイト値とだけあり、並びの説明は小文字・数字・ハイフンの場合だけです
- 「同じだけ具体的」をどう判定するかは、例のほかは書かれていません
- 管理画面の日本語での表記は書かれていません。本文の和訳は英語の原文を訳したものです
- 🔴 本記事は一次ソースからリンクされた API の文書を読んでいません。ストアでも試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の2つです。
- マーケットのメタフィールドを読むアプリやテーマが、マーケットの重なる店で使われているかを洗い出す
- 使われている場合は、並んだときに handle の最も小さいマーケットの値が返る前提で、表示を見直す
店がやることは次の2つです。
- 1人の購入者が2つ以上のマーケットに当たる設定になっているかを見る
- 当たる場合は、どのマーケットの値を見せたいかを決め、Shopify から連絡が来たら handle を直す
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Market metafields break ties between equally specific markets by market handle」2026年11月13日
https://shopify.dev/changelog/posts/market-metafields-break-ties-between-equally-specific-markets-by-market-handle
上記の Shopify 公式の情報だけを一次情報として使っています。

