The market’s web presence, which defines its SEO strategy. This can be a different domain
(e.g. `example.ca`), subdomain (e.g. `ca.example.com`), or subfolders of the primary
domain (e.g. `example.com/en-ca`). Each web presence comprises one or more language
variants. If a market does not have its own web presence, it is accessible on the shop’s
primary domain via [country
selectors](https://shopify.dev/themes/internationalization/multiple-currencies-languages#the-country-selector).
Note: while the domain/subfolders defined by a market’s web presence are not applicable to
custom storefronts, which must manage their own domains and routing, the languages chosen
here do govern [the languages available on the Storefront
API](https://shopify.dev/custom-storefronts/internationalization/multiple-languages) for the countries in
this market.
Access Scopes
`read_markets` for queries and both `read_markets` as well as `write_markets` for mutations.
Fields
alternateLocales:
ShopLocale! -
The ShopLocale object for the alternate locales. When a domain is used, these locales will be
available as language-specific subfolders. For example, if English is an
alternate locale, and `example.ca` is the market’s domain, then
`example.ca/en` will load in English.
defaultLocale:
ShopLocale! -
The ShopLocale object for the default locale. When a domain is used, this is the locale that will
be used when the domain root is accessed. For example, if French is the default locale,
and `example.ca` is the market’s domain, then `example.ca` will load in French.
domain:
Domain -
The web presence’s domain.
This field will be null if `subfolderSuffix` isn't null.
rootUrls:
MarketWebPresenceRootUrl! -
The list of root URLs for each of the web presence’s locales. As of version `2024-04` this value will no longer have a trailing slash.
subfolderSuffix:
String -
The market-specific suffix of the subfolders defined by the web presence. Example: in `/en-us` the subfolder suffix is `us`. This field will be null if `domain` isn't null.