---
title: Markets APIs now support MarketRegionSubdivision - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/markets-apis-now-support-marketregionsubdivision
  md: >-
    https://shopify.dev/changelog/posts/markets-apis-now-support-marketregionsubdivision.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-06-26T10:40:22-04:00'
  postedAt: '2026-07-03T12:00:00-04:00'
  updatedAt: '2026-07-06T08:35:27-04:00'
  effectiveAt: '2026-06-27T12:00:00-04:00'
---

July 3, 2026

# Markets APIs now support MarketRegionSubdivision

DateJuly 3, 2026

FlagsUpdate

SurfacesAPI

**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](https://shopify.dev/docs/apps/build/orders-fulfillment/market-driven-shipping/upgrade-your-app)

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.