---
title: >-
  [DRAFT] 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/markets-apis-now-support-marketregionsubdivision
  md: >-
    https://shopify.dev/changelog/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-03T10:03:09-04:00'
  effectiveAt: '2026-06-27T12:00:00-04:00'
---

July 3, 2026

Tags:

* API

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