[DRAFT] Markets APIs now support MarketRegionSubdivision

Sub-region Markets are available in the Admin GraphQL API 2026-07 release candidate

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.

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.

Shipping apps can get more informtion in the dedicated shipping upgrade guide