Returns the applicable market for a customer based on where they are in the world.
Access Scopes
The user must have markets API access.
Arguments
countryCode:
CountryCode! -
The code for the country where the customer is.
Returns
catalogsCount:
Count
The number of catalogs that belong to the market.
currencySettings:
MarketCurrencySettings!
The market’s currency settings.
enabled:
Boolean!
Whether the market is enabled to receive visitors and sales. **Note**: Regions in inactive
markets can't be selected on the storefront or in checkout.
handle:
String!
A short, human-readable unique identifier for the market. This is changeable by the merchant.
metafield:
Metafield
A [custom field](https://shopify.dev/docs/apps/build/custom-data),
including its `namespace` and `key`, that's associated with a Shopify resource
for the purposes of adding and storing additional information.
name:
String!
The name of the market. Not shown to customers.
priceList:
PriceList
The market’s price list, which specifies a percentage-based price adjustment as well as
fixed price overrides for specific variants.
Markets with multiple catalogs can have multiple price lists. To query which price lists are connected to
a market, please query for price lists through the catalogs connection.
primary:
Boolean!
Whether the market is the shop’s primary market.
privateMetafield:
PrivateMetafield
Returns a private metafield by namespace and key that belongs to the resource.
webPresence:
MarketWebPresence
The market’s web presence, 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 its own web presence, then the market is accessible on the
primary market's domains using [country
selectors](https://shopify.dev/themes/internationalization/multiple-currencies-languages#the-country-selector).
If it's the primary market and it has multiple web presences, then this field will return the primary domain web presence.