Skip to main content
Anchor to Market

Market

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.

Anchor to catalogscatalogs
•MarketCatalogConnection!non-null

The catalogs that belong to the market.

Anchor to catalogsCountcatalogsCount
•Count

The number of catalogs that belong to the market.

Anchor to conditionsconditions
•MarketConditions

The conditions under which a visitor is in the market.

Anchor to currencySettingscurrencySettings
•MarketCurrencySettings

The market’s currency settings.

Anchor to handlehandle
•String!non-null

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

Anchor to idid
•ID!non-null

A globally-unique ID.

Anchor to metafieldmetafield
•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.

Anchor to metafieldsmetafields
•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.

Anchor to namename
•String!non-null

The name of the market. Not shown to customers.

Anchor to priceInclusionspriceInclusions
•MarketPriceInclusions

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

Anchor to statusstatus
•MarketStatus!non-null

Status of the market. Replaces the enabled field.

Anchor to typetype
•MarketType!non-null

The type of the market.

Anchor to webPresenceswebPresences
•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

Anchor to enabledenabled
•Boolean!non-nullDeprecated
Anchor to metafieldDefinitionsmetafieldDefinitions
•MetafieldDefinitionConnection!non-nullDeprecated
Anchor to priceListpriceList
•PriceListDeprecated
Anchor to primaryprimary
•Boolean!non-nullDeprecated
Anchor to regionsregions
•MarketRegionConnection!non-nullDeprecated
Anchor to webPresencewebPresence
•MarketWebPresenceDeprecated
Was this section helpful?

Anchor to QueriesQueries

Anchor to marketmarket
•query

Returns a market resource by ID.

Anchor to marketsmarkets
•query

The markets configured for the shop.

Deprecated queries

Anchor to marketByGeographymarketByGeography
•queryDeprecated
Anchor to primaryMarketprimaryMarket
•queryDeprecated
Was this section helpful?

Anchor to MutationsMutations

Anchor to marketCreatemarketCreate
•mutation

Creates a new market.

Arguments

Anchor to inputinput
•MarketCreateInput!required

The properties of the new market.

Fields

Anchor to marketmarket
•Market

The market object.

Anchor to userErrorsuserErrors
•[MarketUserError!]!non-null

The list of errors that occurred from executing the mutation.

Anchor to marketCurrencySettingsUpdatemarketCurrencySettingsUpdate
•mutation

Updates currency settings of a market.

Arguments

Anchor to inputinput
•MarketCurrencySettingsUpdateInput!required

Properties to update for the market currency settings.

Anchor to marketIdmarketId
•ID!required

The ID of the market definition to target.

Fields

Anchor to userErrorsuserErrors
•[MarketCurrencySettingsUserError!]!non-null

The list of errors that occurred from executing the mutation.

Anchor to marketmarket
•MarketDeprecated
Anchor to marketUpdatemarketUpdate
•mutation

Updates the properties of a market.

Arguments

Anchor to idid
•ID!required

The ID of the market to update.

Anchor to inputinput
•MarketUpdateInput!required

The properties to update.

Fields

Anchor to marketmarket
•Market

The market object.

Anchor to userErrorsuserErrors
•[MarketUserError!]!non-null

The list of errors that occurred from executing the mutation.

Deprecated mutations

Anchor to marketRegionDeletemarketRegionDelete
•mutationDeprecated
Anchor to marketRegionsCreatemarketRegionsCreate
•mutationDeprecated
Anchor to marketWebPresenceCreatemarketWebPresenceCreate
•mutationDeprecated
Anchor to marketWebPresenceDeletemarketWebPresenceDelete
•mutationDeprecated
Anchor to marketWebPresenceUpdatemarketWebPresenceUpdate
•mutationDeprecated
Was this section helpful?

Anchor to InterfacesInterfaces

Was this section helpful?