Markets APIs now support MarketRegionSubdivision

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. Unsupported API paths will return validation errors instead of allowing unsupported configurations.