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 Fields and connectionsFields and connections

Anchor to assignedCustomizationassignedCustomization
•Boolean!non-null

Whether the market has a customization with the given ID.

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

Anchor to metafieldsByIdentifiersmetafieldsByIdentifiers
•[Metafield]!non-null

The metafields associated with the resource matching the supplied list of namespaces and keys.

•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 and connections

•Boolean!non-nullDeprecated
Anchor to metafieldDefinitionsmetafieldDefinitions
•MetafieldDefinitionConnection!non-nullDeprecated
•PriceListDeprecated
•Boolean!non-nullDeprecated
•MarketRegionConnection!non-nullDeprecated
•MarketWebPresenceDeprecated

Was this section helpful?

•query

Returns a market resource by ID.

•query

The markets configured for the shop.

Deprecated queries


Was this section helpful?

•mutation

Creates a new market.

Arguments

•MarketCreateInput!required

The properties of the new market.


Fields

•Market

The market object.

•[MarketUserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Updates currency settings of a market.

Arguments

•MarketCurrencySettingsUpdateInput!required

Properties to update for the market currency settings.

•ID!required

The ID of the market definition to target.


Fields

•[MarketCurrencySettingsUserError!]!non-null

The list of errors that occurred from executing the mutation.

•MarketDeprecated
•mutation

Updates the properties of a market.

Arguments

•ID!required

The ID of the market to update.

•MarketUpdateInput!required

The properties to update.


Fields

•Market

The market object.

•[MarketUserError!]!non-null

The list of errors that occurred from executing the mutation.

Deprecated mutations


Was this section helpful?


Was this section helpful?