Configure Shopify Markets with localized domains, language, and tax settings, and set market-specific product pricing via the Markets Admin GraphQL API
domain: shopify.dev · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
In-depth guide
Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.dev, checked against official docs, with linked verified routes.
Steps
Query existing markets with the markets connection to understand the primary market structure before making changes
Create a new market with marketCreate, specifying regions (countryCodes array), name, and enabled:true; associate a web presence (domain or subfolderSuffix) via marketWebPresenceCreate
Set price adjustments for the market using priceListCreate or priceListUpdate with a currency and catalogPriceAdjustment; link the price list to the market via marketCatalogCreate
Configure tax settings per market with marketLocalizationRegisterTranslations or by updating the market's taxSettings field to set tax-inclusive pricing flags for the target region
Test by calling the Storefront API with the X-Shopify-Storefront-Access-Token and country/language headers matching the market to confirm correct currency and locale resolution
Known gotchas
A market web presence domain must be verified in Shopify's domain settings before it can be activated; using an unverified domain returns an error on marketWebPresenceCreate
Price list adjustments are percentage-based by default; to set explicit fixed prices per variant for a market, use priceListFixedPricesAdd with individual variantId and price entries
Markets and catalogs have a many-to-one relationship with price lists — one price list can serve multiple markets but a market can only have one active catalog at a time
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?