Choose a version:

MarketConnection

connection

An auto-generated type for paginating through multiple Markets.

Anchor to Fields with this connectionFields with this connection

Anchor to MarketCatalog.markets MarketCatalog.markets •OBJECT: A catalog for managing product availability and pricing for specific Market contexts. Each catalog links to one or more markets and defines what Product objects customers see through its Publication settings. The catalog can include a PriceList for market-specific pricing adjustments.

Use catalogs to create distinct shopping experiences for different geographic regions or customer segments.

Learn more about building a catalog and managing markets.
Anchor to MarketWebPresence.markets MarketWebPresence.markets •OBJECT: The market’s web presence, which defines its SEO strategy. This can be a different domain (e.g. example.ca), subdomain (e.g. ca.example.com), or subfolders of the primary domain (e.g. example.com/en-ca). Each web presence comprises one or more language variants. If a market does not have its own web presence, it is accessible on the shop’s primary domain via country selectors.

Note: while the domain/subfolders defined by a market’s web presence are not applicable to custom storefronts, which must manage their own domains and routing, the languages chosen here do govern the languages available on the Storefront API for the countries in this market.

Was this section helpful?

Anchor to Queries with this connectionQueries with this connection

Anchor to markets markets

•query

Returns a paginated list of Market objects configured for the shop. Markets match buyers based on defined conditions to deliver customized shopping experiences.

Filter markets by MarketType and MarketStatus, search by name, and control sort order. Retrieve market configurations including MarketCurrencySettings, MarketWebPresence objects, and MarketConditions.

Learn more about Shopify Markets.

Arguments

Anchor to enabledenabled

•Boolean

Default:null

Filters markets by enabled status.

Anchor to typetype

•MarketType

Default:null

Filters markets by type.

Anchor to firstfirst

•Int

The first n elements from the paginated list.

Anchor to afterafter

•String

The elements that come after the specified cursor.

Anchor to lastlast

•Int

The last n elements from the paginated list.

Anchor to beforebefore

•String

The elements that come before the specified cursor.

Anchor to reversereverse

•Boolean

Default:false

Reverse the order of the underlying list.

Anchor to sortKeysortKey

•MarketsSortKeys

Default:NAME

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

Anchor to queryquery

•String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to default •string: Filter by a case-insensitive search of multiple fields in a document.
Anchor to id •id: Filter by id range.
Anchor to market_condition_types •string: A comma-separated list of condition types.
Anchor to market_type •string
Anchor to name •string
Anchor to status •string
Anchor to wildcard_company_location_with_country_code •string

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?