How to Fix Hreflang in Shopify (Markets, Languages)
Shopify hreflang implementation depends on whether you use Shopify Markets (single store, multiple regions/languages) or a multi-store setup (separate stores per region). Both need correct hreflang. This guide covers both. Pair with hreflang guide and WordPress version.
Step-by-step: How to configure hreflang on Shopify
- Choose strategy: Markets or multi-store. Shopify Markets (since 2022): single store, multiple regional/language versions via subdirectories. Multi-store: separate Shopify stores per region (e.g., yourstore.com, yourstore.fr). Markets is easier and recommended for most; multi-store gives more independence but more complexity.
- Configure Shopify Markets. Settings → Markets → add markets per country/region. Enable Translate & Adapt for language translations within each market. Configure subdirectory pattern (/fr-fr/, /en-gb/) or subdomain.
- Verify hreflang output. Visit a translated page. View source → look for link rel='alternate' hreflang='X' tags. Markets should generate these automatically once configured. Should include all your active markets plus x-default.
- Set x-default. Markets automatically sets x-default to your primary market. Verify in Markets settings → primary market designation. Usually your largest market or English-language version.
- Validate. hreflang.xyz, Aleyda Solis validator, or Ahrefs hreflang checker. Common errors: missing return tags (Markets should prevent these but worth verifying), mismatched language codes, x-default pointing wrong.
- Handle currency separately. Currency conversion is independent of language/hreflang. Markets handles currency too — set per-market currency. Don't confuse currency display with hreflang language targeting.
- Monitor in Search Console. Search Console → International Targeting → Language. Reports hreflang errors. Watch 'No return tags' count.
🌐 Validate Shopify hreflang
Find missing return tags, mismatched codes and Market issues.
Run Hreflang Validator →Frequently Asked Questions
Shopify Markets vs multi-store for international expansion?
Markets: easier, single store to manage, subdirectory URLs, automatic hreflang, shared product catalogue. Multi-store: complete independence per region (different product mix, different pricing, different team management), but multiple Shopify subscriptions and manual cross-store coordination. Markets fits 80%+ of international Shopify stores.
Does Shopify Markets handle hreflang automatically?
Yes once configured. Each market's URLs (e.g., /fr-fr/products/X) automatically include hreflang link tags pointing to other market versions. Verify in view-source after enabling markets. If hreflang missing, check market is published and language is set up correctly.
Can I use Weglot or other translation apps with hreflang?
Yes. Weglot, Langify, GTranslate all output hreflang for their translated URLs. They typically use subdirectory patterns and handle the return tags. Verify each app's hreflang output post-install. Don't run multiple translation apps simultaneously — hreflang conflicts.
Why is Search Console showing 'No return tags' on Shopify Markets?
Usually a single missing market or recently-changed Markets configuration. Markets generates hreflang from active market settings. If you removed a market but old URLs still have hreflang pointing at it, you'll see errors. Search Console takes 2-4 weeks to fully refresh after Markets changes.
Should I use ccTLDs (.fr, .de) with Shopify?
Possible via multi-store but operationally heavy. Each ccTLD = separate Shopify store. Markets uses subdirectory or subdomain pattern instead. For most stores, Markets subdirectories give 90% of ccTLD's SEO benefit at 10% of operational cost.