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
•PriceList
Deprecated
•Boolean!
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
•query
Deprecated

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.

•Market
Deprecated
•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

•mutation
Deprecated

Arguments

•ID!
required

The ID of the market region to delete.


Fields

•ID

The ID of the deleted market region.

•Market

The parent market object of the deleted region.

•[MarketUserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation
Deprecated

Arguments

•ID!
required

The ID of the market to add the regions to.

•[MarketRegionCreateInput!]!
required

The regions to be created.


Fields

•Market

The market object.

•[MarketUserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation
Deprecated

Arguments

•ID!
required

The ID of the market for which to create a web presence.

•MarketWebPresenceCreateInput!
required

The details of the web presence to be created.


Fields

•Market

The market object.

•[MarketUserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation
Deprecated

Arguments

•ID!
required

The ID of the web presence to delete.


Fields

•ID

The ID of the deleted web presence.

•Market

The market for which the web presence was deleted.

•[MarketUserError!]!
non-null

The list of errors that occurred from executing the mutation.

•mutation
Deprecated

Arguments

•MarketWebPresenceUpdateInput!
required

The web_presence fields used to update the market's web presence.

•ID!
required

The ID of the web presence to update.


Fields

•Market

The market object.

•[MarketUserError!]!
non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?


Was this section helpful?
OSZAR »