2027-01, Market.metafields matches requested keys regardless of letter case. If your custom storefront expects a differently cased key to return null, test before upgrading. The singular Market.metafield already behaved this way.On this page
Why this happens or what changed
Earlier Storefront API versions required matching case for the plural field, even though the singular field ignored case. That inconsistency disappears in 2027-01. A key stored as colour can now be returned for a request for Colour. This matters for conditional market banners, pricing hints, region copy, and overlapping markets with case-variant keys; it does not mean Shopify has renamed your metafield keys.
Practical fix
- Inventory
Market.metafields(identifiers: ...)queries in your custom storefront and apps, including generated queries. - Compare each requested namespace/key to the actual stored casing across markets; standardize casing in application code and data.
- Before switching versions, query the singular and plural fields for the same identifier. A mismatch identifies behavior that may change on 2027-01.
- Review any fallback that treats a null plural result as a signal to show global content. That fallback may stop running when the key becomes findable.
- Test affected countries and overlapping markets; coordinate this check with the separate November 13 market-handle tie-break change.
Production example
query CompareMarketKeys @inContext(country: CA) {
localization {
market {
singular: metafield(namespace: "custom", key: "Colour") { key value }
plural: metafields(identifiers: [{namespace: "custom", key: "Colour"}]) { key value }
}
}
}
Run this first against your current API version. If singular returns a value but the plural array entry is null, expect the plural query to find a value on 2027-01. Use the same country context in both comparisons.
How to test this
- Create a market metafield with key
colourand requestColourfrom a controlled buyer context. - On 2026-10, compare singular and plural results; note the expected mismatch.
- On a 2027-01 test endpoint, verify the plural query now returns the value.
- Repeat with exactly cased keys, multiple market contexts, and fallback rendering.
- Confirm the production storefront has no logic depending on a null response from mismatched case.

