---
title: MarketRelationship - GraphQL Admin
description: Represents a parent/child relationship between two markets.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketRelationship'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketRelationship.md
api_name: admin
api_type: graphql
type: object
---

# Market​Relationship

object

Requires `read_markets` for queries and both `read_markets` as well as `write_markets` for mutations.

Represents a parent/child relationship between two markets.

## Fields

* child​Market

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

  non-null

  The child market in the relationship.

* id

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

  non-null

  The unique identifier for the market relationship.

* parent​Market

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

  The parent market in the relationship.

***

## Map

### Fields and connections with this object

* [MarketRelationshipConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketRelationshipConnection#returns-nodes)
* [MarketRelationshipEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketRelationshipEdge#field-MarketRelationshipEdge.fields.node)

***

## Queries

* [market​Relationships](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketRelationships)

  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).

  * after

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

    ### Arguments

    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.

  ***

***

## MarketRelationship Queries

### Queried by

* [market​Relationships](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketRelationships)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## MarketRelationship Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)