Query market hierarchies with the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 17, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-10.
What changed
The new marketRelationships query returns a connection of MarketRelationship objects. Each relationship includes a childMarket and a nullable parentMarket. The parentMarket field is null if the childMarket is a root market. The Market object now includes: parentMarkets: The market’s direct parent markets. parentMarketsCount: The number of direct parent markets.
Who is affected
This change applies to apps that use GraphQL Admin API version 2026-10 or later and need to inspect or traverse market relationships. Apps that use API versions before 2026-10 can’t query the new fields. Apps that don’t query markets are unaffected.
What action may be needed
No action is required for existing apps. Your existing integrations keep working on older API versions without changes. To use the market hierarchy fields: Use GraphQL Admin API version 2026-10 or later. Confirm that your app has the read_markets access scope.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →