detektu
Shopify API changes
Info

Query market hierarchies with the GraphQL Admin API

doc:019fb619-9b4a-74ac-a83e-3ffa98844fb4::feed/https://shopify.dev/changelog/market-relationships
Product
Shopify Admin GraphQL API
Source
Feed
Change kind
Feed Entry
Detected
Last updated

Deterministic evidence

Before / after

Extracted from Shopify's published contract. Open the source ↗

−1+81 change

1 / 1
null
{
"content_hash": "f58654702afef8e70280fb1d9ae7fe2b93f68a7f89d7368ac6fa16d0fc911a18",
"excerpt": "The GraphQL Admin API now includes fields for querying and traversing a store’s market hierarchy in API version 2026-10. Apps that use the read_markets access scope can retrieve parent-child relationships, navigate between related markets, and check if the asynchronously rebuilt relationship data has changed. No action is required for existing apps. What changed The new marketRelationships query returns a connection of MarketRelationship objects. Each relationship includes a childMarket and a nu…",
"identity": "https://shopify.dev/changelog/market-relationships",
"link": "https://shopify.dev/changelog/market-relationships",
"published_at": "2026-09-17T16:00:00Z",
"title": "Query market hierarchies with the GraphQL Admin API"
}

Interpreted documentation change

What the vendor announced

The evidence describes a Shopify changelog entry announcing GraphQL Admin API enhancements in version 2026-10, adding marketRelationships query and related capabilities for querying a store’s market hierarchy. It states no action required for existing apps and mentions read_markets scope. No explicit deprecation, rate limit, or endpoint replacement is indicated.

Query market hierarchies with the GraphQL Admin API The GraphQL Admin API now includes fields for querying and traversing a store’s market hierarchy in API version 2026-10. Apps that use the read_markets access scope can retrieve parent-child relationships, navigate between related markets, and check if the asynchronously rebuilt relationship data has changed. No action is required for existing apps. What changed The new marketRelationships query returns a connection of MarketRelationship objects. Each relationship includes a childMarket and a nu…

Vendor source ↗

Monitored for you

Does this change affect your integration?

Choose the operations and fields your services use. Detektu matches Shopify findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.

Monitor Shopify free See pricing

Multi-source correlation

Other Shopify findings correlated with this change across sources.

  1. Potentially breaking
    SDK release 15.0.0sdk:npm/@shopify/shopify-api@15.0.0
    Shopify Admin GraphQL API
  2. Potentially breaking
    SDK release 15.0.0sdk:npm/@shopify/shopify-api@15.0.0
    Shopify Admin GraphQL API