Shopify APIBreaking changehigh

Shopify Storefront API 2027-01 makes Market.metafields key matching case-insensitive

Detected
Nov 14, 2026
Effective
Nov 13, 2026(took effect 3 days ago)
Confidence
85%

What changed

Shopify Storefront API 2027-01 introduces a breaking change where Market.metafields now matches keys in any case (case-insensitive). Additionally, market metafields break ties between equally specific markets by market handle, and Checkout Function cart.deliverableLine inputs now model cost and link to their relevant cart.line.

What to do

Audit any code relying on case-sensitive metafield key matching in Market.metafields queries against Storefront API 2027-01+. Also review market tie-breaking logic and Checkout Function cart.deliverableLine usage for cost and line linkage changes.

Affected

model: Market.metafieldsmodel: cart.deliverableLineendpoint: Storefront API 2027-01

Source: shopify.dev (Shopify's own page, checked by Breakwatch)

Is your code affected?

Search your repositories for the Shopify SDK and the names above:

npm: @shopify/shopify-apinpm: shopify-api-noderuby: shopify_apiphp: shopify/shopify-apipip: ShopifyAPI

Or let Breakwatch do it: connect a repo and see which files call Shopify, then get the next change as an alert pointing at those files. Check a repo free

Get Shopify API changes by email

Once a week: the breaking changes and upcoming deadlines for Shopify, each linked to the vendor's own page. Free, no account. One-click unsubscribe.

More Shopify API changes

Every Shopify API change →