Skip to main content
object

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

A market is a group of one or more regions that you want to target for international sales. By creating a market, you can configure a distinct, localized shopping experience for customers from a specific area of the world. For example, you can change currency, configure international pricing, or add market-specific domains or subfolders.

MarketCatalogConnection!
non-null

The catalogs that belong to the market.

Count

The number of catalogs that belong to the market.

MarketCurrencySettings!
non-null

The market’s currency settings.

String!
non-null

A short, human-readable unique identifier for the market. This is changeable by the merchant.

ID!
non-null

A globally-unique ID.

Metafield

A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

MetafieldConnection!
non-null

A list of custom fields that a merchant associates with a Shopify resource.

String!
non-null

The name of the market. Not shown to customers.

MarketWebPresenceConnection!
non-null

The market’s web presences, which defines its SEO strategy. This can be a different domain, subdomain, or subfolders of the primary domain. Each web presence comprises one or more language variants. If a market doesn't have any web presences, then the market is accessible on the primary market's domains using country selectors.

Deprecated fields

Boolean!
non-nullDeprecated
Anchor to metafieldDefinitionsmetafieldDefinitions
MetafieldDefinitionConnection!
non-nullDeprecated
PriceList
Deprecated
Boolean!
non-nullDeprecated
PrivateMetafield
Deprecated
PrivateMetafieldConnection!
non-nullDeprecated
MarketRegionConnection!
non-nullDeprecated
MarketWebPresence
Deprecated

Was this section helpful?

query

Returns a market resource by ID.

query

Returns the applicable market for a customer based on where they are in the world.

query

The markets configured for the shop.

query
Deprecated

Was this section helpful?

mutation

Creates a new market.

mutation

Updates currency settings of a market.

mutation

Updates the properties of a market.

Deprecated mutations

mutation
Deprecated
mutation
Deprecated

Was this section helpful?