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](https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate),
[configure international pricing](https://shopify.dev/apps/internationalization/product-price-lists),
or [add market-specific domains or subfolders](https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence).
Access Scopes
`read_markets` for queries and both `read_markets` as well as `write_markets` for mutations.
Fields
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.
metafieldsByIdentifiers:
Metafield! -
The metafields associated with the resource matching the supplied list of namespaces and keys.
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.
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.