---
title: marketRelationships - GraphQL Admin
description: >-
  The relationships between all markets in the shop. Eventually consistent
  following a change in market hierarchy.

  See
  [`marketRelationshipsStatus`](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketRelationshipsStatus).
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/queries/marketRelationships
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/queries/marketRelationships.md
api_name: admin
api_type: graphql
type: query
---

# market​Relationships

query

The relationships between all markets in the shop. Eventually consistent following a change in market hierarchy. See [`marketRelationshipsStatus`](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketRelationshipsStatus).

## MarketRelationshipConnection arguments

[MarketRelationshipConnection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketRelationshipConnection)

* after

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

* before

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

* first

  [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

  The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

* last

  [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

  The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

* reverse

  [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  Default:false

  Reverse the order of the underlying list.

***

## Possible returns

* edges

  [\[Market​Relationship​Edge!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketRelationshipEdge)

  non-null

  The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.

* nodes

  [\[Market​Relationship!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketRelationship)

  non-null

  A list of nodes that are contained in MarketRelationshipEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/admin-graphql/latest/objects/PageInfo)

  non-null

  An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page.

***

## Examples

* ### marketRelationships reference