Market
Requires for queries and both as well as 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 catalogscatalogs•Market
Catalog Connection! non-null The catalogs that belong to the market.
- Anchor to catalogsCountcatalogs•Count
Count The number of catalogs that belong to the market.
- Anchor to currencySettingscurrency•Market
Settings Currency Settings! non-null 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.
- •ID!non-null
A globally-unique ID.
- Anchor to metafieldmetafield•Metafield
A custom field, including its
namespaceandkey, that's associated with a Shopify resource for the purposes of adding and storing additional information.- Anchor to metafieldsmetafields•Metafield
Connection! non-null A list of custom fields that a merchant associates with a Shopify resource.
- Anchor to namename•String!non-null
The name of the market. Not shown to customers.
- Anchor to webPresencesweb•Market
Presences Web Presence Connection! 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 metafieldDefinitionsmetafield•Metafield
Definitions Definition Connection! non-nullDeprecated - Anchor to priceListprice•Price
List List Deprecated - Anchor to primaryprimary•Boolean!non-nullDeprecated
- Anchor to regionsregions•Market
Region Connection! non-nullDeprecated - Anchor to webPresenceweb•Market
Presence Web Presence Deprecated
Anchor to QueriesQueries
- •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.
- •queryDeprecated
Anchor to MutationsMutations
- •mutation
Creates a new market.
- Anchor to inputinput•Market
Create Input! required The properties of the new market.
Arguments
- Anchor to marketmarket•Market
The market object.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates currency settings of a market.
- Anchor to inputinput•Market
Currency Settings Update Input! required Properties to update for the market currency settings.
- Anchor to marketIdmarket•ID!
Id required The ID of the market definition to target.
Arguments
- Anchor to marketmarket•Market
The market object.
- Anchor to userErrorsuser•[Market
Errors Currency Settings User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates the properties of a market.
- •ID!required
The ID of the market to update.
- Anchor to inputinput•Market
Update Input! required The properties to update.
Arguments
- Anchor to marketmarket•Market
The market object.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •ID!
Deprecated mutations
- •mutationDeprecated
- •ID!required
The ID of the market region to delete.
Arguments
- Anchor to deletedIddeleted•ID
Id The ID of the deleted market region.
- Anchor to marketmarket•Market
The parent market object of the deleted region.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •ID!
- •mutationDeprecated
- Anchor to marketIdmarket•ID!
Id required The ID of the market to add the regions to.
- Anchor to regionsregions•[Market
Region Create Input!]! required The regions to be created.
Arguments
- Anchor to marketmarket•Market
The market object.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •mutationDeprecated
- Anchor to marketIdmarket•ID!
Id required The ID of the market for which to create a web presence.
- Anchor to webPresenceweb•Market
Presence Web Presence Create Input! required The details of the web presence to be created.
Arguments
- Anchor to marketmarket•Market
The market object.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •mutationDeprecated
- Anchor to webPresenceIdweb•ID!
Presence Id required The ID of the web presence to delete.
Arguments
- Anchor to deletedIddeleted•ID
Id The ID of the deleted web presence.
- Anchor to marketmarket•Market
The market for which the web presence was deleted.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields
- •mutationDeprecated
- Anchor to webPresenceweb•Market
Presence Web Presence Update Input! required The web_presence fields used to update the market's web presence.
- Anchor to webPresenceIdweb•ID!
Presence Id required The ID of the web presence to update.
Arguments
- Anchor to marketmarket•Market
The market object.
- Anchor to userErrorsuser•[Market
Errors User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields