Shopify Markets and localized pricing and catalogs

In-depth guide

Steps

1. Create and configure Markets in the Shopify admin or via the marketCreate Admin GraphQL mutation, specifying countries and a primary country.
2. Set market-specific pricing using marketCatalogCreate to create a catalog scoped to a market, and attach a price list with currency and pricing adjustments.
3. Use marketUpdate to configure currency, market-specific domains or subfolders, and tax-inclusive pricing settings for each market.
4. In the Storefront API, set the buyer's countryCode on the cart via cartBuyerIdentityUpdate or pass it as a @inContext directive argument (e.g., @inContext(country: CA)) on product queries to retrieve localized prices.
5. Localized prices are returned in the product.variants.price and cart.cost fields when countryCode is resolved to a market with a catalog.
6. Test price resolution by querying product.variants.contextualPricing with country argument to verify correct prices before and after enabling a market catalog.