[DRAFT] Markets APIs now support MarketRegionSubdivision

Shopify Admin GraphQL API 2026-07 Adds Sub-Region Market Support

Shopify’s Admin GraphQL API 2026-07 release candidate now includes support for country-subdivision regions in Markets through the new MarketRegionSubdivision type. This update allows apps to work with Markets configured at the state and province level, rather than only at the country level.

What Developers Need to Know

The API introduces MarketRegionSubdivision as the stable type for handling country subdivisions like US states or Canadian provinces. Developers should query sub-region membership through market.conditions.regionsCondition.regions instead of the deprecated market.regions field.

This change becomes relevant as merchants adopt market-driven shipping configurations that target specific subdivisions within countries. Apps using Admin GraphQL 2026-07 will encounter these subdivision-based Markets in production environments.

Implementation Requirements

Developers building or maintaining apps that interact with Markets data need to update their GraphQL queries to handle the new subdivision type. The deprecated market.regions field should no longer be used as the source of truth for region data.

Apps that display market configurations, manage shipping rules, or handle geographic targeting will need to account for both country-level and subdivision-level Markets. The API change ensures apps can accurately read and process market configurations as merchants implement more granular geographic targeting for their stores.

The 2026-07 API version is currently in release candidate status, giving developers time to test and update their implementations before the stable release.

Read the full announcement →