MarketWebPresence
object

Choose a version:

Requires read_markets for queries and both read_markets as well as write_markets for mutations.

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.

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 for the countries in this market.

Anchor to section titled 'Fields'

Fields

Anchor to MarketWebPresence.alternateLocales alternateLocales [ShopLocale!]! non-null: 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.
Anchor to MarketWebPresence.defaultLocale defaultLocale ShopLocale! non-null: 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.
Anchor to MarketWebPresence.domain domain Domain: The web presence’s domain. This field will be null if subfolderSuffix isn't null.
Anchor to MarketWebPresence.id id ID! non-null: A globally-unique ID.
Anchor to MarketWebPresence.market market Market: The associated market. This can be null for a web presence that isn't associated with a market.
Anchor to MarketWebPresence.rootUrls rootUrls [MarketWebPresenceRootUrl!]! non-null: 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.
Anchor to MarketWebPresence.subfolderSuffix 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.