Markets APIs now support MarketRegionSubdivision
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on July 03, 2026.
This Shopify update is categorized as API, Update.
What changed
Sub-region Markets are available in the Admin GraphQL API 2026-07 Apps using Admin GraphQL 2026-07 can encounter Markets configured with country-subdivision regions, such as states and provinces as merchants upgrade to market-driven shipping. Apps can get more informtion about market-drive shipping feature preview shipping upgrade guide Use MarketRegionSubdivision as the stable country-subdivision region type, and read sub-region membership through market.conditions.regionsCondition.regions. Do not use deprecated market.regions as the source of truth for sub-region membership, because it may omit subdivision regions. Sub-region Markets support shipping first. Other configurations including Discounts, Catalogs, Theme contextualization, Market metafields, are not yet supported.
Who is affected
Apps that read, write, translate, or depend on Shopify metafields should review this change.
What action may be needed
Review the official Shopify entry, confirm whether the change touches your app, and test the affected workflow before your next relevant deployment.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →