CatalogScan
SEO Guide · 2026
Shopify International SEO for AI Shopping Agents
Shopify Markets is the right tool for multi-country selling — but the way it handles URLs, pricing, and structured data creates five non-obvious problems for AI agent catalog indexing. A shopper in Germany asking Perplexity Shopping for "wireless earbuds under €150" sees different stores than a US shopper asking the same question in dollars — your market-specific structured data is what determines which candidate set you're in.
How Shopify Markets creates international URLs
Shopify Markets (launched 2023, now the default international tool for Shopify Plus and Advanced) generates market-specific storefronts via one of three URL structures:
- Subfolders —
yourstore.com/en-de/for Germany (recommended for SEO) - Subdomains —
de.yourstore.com(acceptable, harder to manage) - Separate domains —
yourstore.de(highest authority per market, hardest to maintain)
For AI agent indexing, subfolders are strongly preferred. They consolidate domain authority and allow AI crawlers to index all market variants from a single crawl of your primary domain. Subdomains and separate domains require separate crawl budgets and can result in one market being fully indexed while others are not.
The five international AI agent problems we see most often
-
Problem 1: JSON-LD Offer price is in USD even for non-US marketsFix: Ensure your theme generates the Offer JSON-LD dynamically with the market-specific price. Shopify Markets sets the correct price in the storefront context — your Liquid template must read
product.selected_or_first_available_variant.pricein the current market context, not the default market context. -
Problem 2: hreflang tags point to non-existent market URLsFix: Shopify Markets generates hreflang tags automatically in the default theme — but only for markets you've explicitly enabled in Shopify Admin. If you've created Markets in Admin but haven't published them, hreflang tags for those markets point to 404 pages. Agents that follow hreflang and hit 404s drop your international pages from consideration.
-
Problem 3: geo-redirect rules block AI crawler access to non-primary marketsFix: Cloudflare geo-redirect rules (or similar) often redirect AI crawlers from their US-based IP addresses to the US storefront, preventing them from crawling EU or UK market variants. Exempt known AI crawler UAs from geo-redirect rules the same way you exempt them from Bot Fight Mode.
-
Problem 4: /products.json returns default market pricing regardless of market contextFix: Shopify's products.json endpoint doesn't respect market context — it always returns prices in your store's default currency. For international AI agents, use the Storefront API with market-specific context (passing the buyer's country in the storefrontApiCustomerAccessToken context) to return market-accurate pricing.
-
Problem 5: GTIN is correct but product availability differs by market without being reflected in JSON-LDFix: If a product is available in the US but not shipped to Germany, the Offer JSON-LD for the German market must reflect this — OutOfStock or Discontinued for that market's Offer, not InStock. Agents that receive InStock for a product they can't purchase lose trust in your catalog data and downweight your listings.
Sitemap requirements for international stores
Shopify generates one sitemap at /sitemap.xml. For Markets-enabled stores, it includes all market-specific URLs in a single sitemap index. Verify that all your enabled markets appear in the sitemap — not just the primary market. If a market URL isn't in the sitemap, AI crawlers must discover it via hreflang or internal links, which is slower and less reliable.
For large international stores (10+ markets, 1000+ products), the sitemap can exceed 50,000 URLs. Verify that Shopify is generating the sitemap index correctly (multiple sitemap files linked from sitemap.xml) rather than a single oversized file that times out during indexing.
FAQ
Does Agentic Storefronts work for non-US merchants?
As of June 2026, Shopify Agentic Storefronts via the Shopify Global Catalog is US-only for the initial rollout. Merchants in the UK, EU, Australia, and Canada can still be indexed by ChatGPT Shopping and Perplexity Shopping via their direct crawl mechanism — but the Shopify Global Catalog join (for cross-store comparison queries) is not available outside the US yet. Check Shopify's Markets documentation for rollout schedule updates.
Should I use Shopify Translate & Adapt for AI SEO?
Shopify Translate & Adapt (T&A) handles content translation for Markets. It doesn't affect your structured data directly — JSON-LD is still generated from your Liquid template. However, translated product descriptions in T&A should include the same qualifying attributes (material, fit, category keywords) as your primary language descriptions, since AI agents process translated descriptions as well as the primary language version.
CatalogScan only scans one URL — will it catch international issues?
CatalogScan's free scan checks the primary market version of your store. The Pro tier adds multi-market scanning — enter your store URL with a market prefix (e.g., yourstore.com/en-gb/) and CatalogScan checks that market's structured data, hreflang, and pricing consistency separately. International signal gaps are often different from primary market gaps.
Check your international store's AI readiness
Scan your store — including market-specific URLs — to see which international signals are missing.
Run the free scan →