Choose a version:

markets

query

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

The markets configured for the shop.

MarketConnection arguments

•MarketConnection!

Anchor to afterafter • String: The elements that come after the specified cursor.
Anchor to beforebefore • String: The elements that come before the specified cursor.
Anchor to firstfirst • Int: The first n elements from the paginated list.
Anchor to lastlast • Int: The last n elements from the paginated list.
Anchor to reversereverse • BooleanDefault:false: Reverse the order of the underlying list.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to edgesedges • [MarketEdge!]!non-null: The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.
Anchor to nodesnodes • [Market!]!non-null: A list of nodes that are contained in MarketEdge. 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.
Anchor to pageInfopageInfo • PageInfo!non-null: An object that’s used to retrieve cursor information about the current page.

Was this section helpful?

Get market web presences and their root URLs
Get the first four markets

Examples

Open in GraphiQL

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query Markets {

markets(first: 4) {

nodes {

name

webPresence {

rootUrls {

locale

url

}

}`,

);

const data = await response.json();

query Markets {
  markets(first: 4) {
    nodes {
      name
      webPresence {
        rootUrls {
          locale
          url
        }
      }
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query Markets { markets(first: 4) { nodes { name webPresence { rootUrls { locale url } } } } }"
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  query Markets {
    markets(first: 4) {
      nodes {
        name
        webPresence {
          rootUrls {
            locale
            url
          }
        }
      }
    }
  }`,
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query Markets {
    markets(first: 4) {
      nodes {
        name
        webPresence {
          rootUrls {
            locale
            url
          }
        }
      }
    }
  }`,
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query Markets {
    markets(first: 4) {
      nodes {
        name
        webPresence {
          rootUrls {
            locale
            url
          }
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Response

JSON

{

"markets": {

"nodes": [

{

"name": "Canada",

"webPresence": {

"rootUrls": [

{

"locale": "en",

"url": "https://defaultglobal.com/en-ca"

{

"locale": "fr",

"url": "https://defaultglobal.com/fr-ca"

}

]

}

{

"name": "European Union",

"webPresence": {

"rootUrls": [

{

"locale": "en",

"url": "https://defaultglobal.com/en-eu"

{

"locale": "es",

"url": "https://defaultglobal.com/es-eu"

{

"locale": "fr",

"url": "https://defaultglobal.com/fr-eu"

}

]

}

{

"name": "United Kingdom",

"webPresence": {

"rootUrls": [

{

"locale": "en",

"url": "https://uk.defaultglobal.com"

}

]

}

{

"name": "United States",

"webPresence": {

"rootUrls": [

{

"locale": "en",

"url": "https://defaultglobal.com"

{

"locale": "es",

"url": "https://defaultglobal.com/es"

}

]

}

]

}