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.

Anchor to assignedCustomizationassignedCustomization
Boolean!
non-null

Whether the market has a customization with the given ID.

Arguments

ID!
required

The ID of the customization that the market has been assigned to.


MarketCatalogConnection!
non-null

The catalogs that belong to the market.

Count

The number of catalogs that belong to the market.

MarketConditions

The conditions under which a visitor is in the market.

MarketCurrencySettings

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.

MarketPriceInclusions

The inclusive pricing strategy for a market. This determines if prices include duties and / or taxes.

MarketStatus!
non-null

Status of the market. Replaces the enabled field.

MarketType!
non-null

The type of the market.

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
MarketRegionConnection!
non-nullDeprecated
MarketWebPresence
Deprecated

Was this section helpful?

query

Returns a market resource by ID.

query

The markets configured for the shop.

Deprecated queries

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?