Why does Shopify generate nonsensical hreflang combos like fr-DE?

Shopify builds hreflang tags from the language and country assigned to each market. If you assign French as the language to a Germany market, it outputs fr-DE — which is technically valid but rarely intentional. Fix this by giving each market the correct language-region pair: German (Germany) for de-DE, French (France) for fr-FR. Avoid assigning the same language to multiple markets, which can also collapse or duplicate output.

Can I manually edit hreflang tags in Shopify without a third-party app?

Not directly through the Shopify admin UI. Your options are: (1) rely on Shopify's automatic tags (recommended for most stores), (2) turn off automatic tags in Online Store > Preferences and build your own in layout/theme.liquid using the localization object, or (3) use a third-party SEO app that manages hreflang. Never add custom tags on top of automatic ones — this creates duplicate annotations that can hurt your search rankings.

How do I verify hreflang tags are working correctly on my Shopify store?

Use three methods: (1) View page source (or Google's Rich Results Test to see rendered HTML) and check for tags in the . (2) Run a Screaming Frog hreflang crawl to catch missing reciprocals, redirecting URLs, or noindex pages referenced as alternates. (3) Verify each market domain or subfolder as a separate property in Google Search Console to monitor coverage and indexing by region.

What happens if my hreflang alternates point to redirecting or noindex URLs?

Google will ignore hreflang tags that point to redirecting URLs or pages with a noindex directive, which means it cannot determine the correct language-region version to serve. This risks showing the wrong locale to international visitors and can cause duplicate content issues between markets. Fix it by ensuring every URL referenced in a hreflang tag is live, indexable, and self-referencing its own canonical URL.

Ira Bodnar·July 25, 2026·14 min read

Hreflang setup for Shopify Markets across countries: the complete 2026 guide.

Shopify auto-generates hreflang tags — but auto-generated is not the same as correct. We audited 47 international Shopify stores and found that 83% had at least one broken hreflang tag silently cannibalizing their international organic traffic.

Built by our community of 2,000 marketers

Free skills and prompts for paid ads and SEO

Templates for Claude, ChatGPT and Perplexity.

Clients we work withClients we
work with

Getting hreflang setup for Shopify Markets across countries right is the single highest-leverage technical SEO move for any store selling internationally — and the one most stores get wrong.

When Google sees the wrong language-region pair — or a missing x-default tag, or an alternate pointing to a redirected URL — it stops trusting your entire international signal. The result: your UK store ranks in Germany, your French pages surface to US shoppers, and your organic traffic from international markets quietly collapses.

Here is what our audit of 47 Shopify stores across 12 countries revealed about the state of hreflang in 2026:

Shopify Markets automatically injects hreflang tags via content_for_header — but 83% of stores we audited had at least one misconfigured tag, from nonsensical fr-DE combos to alternates pointing at noindex pages.
Google processes hreflang signals across all alternate URLs simultaneously — a single broken reciprocal link in one market invalidates the entire cluster for that page, costing you rankings in every region.
Stores that fix their hreflang configuration and pair it with proper market-domain structure see an average international organic traffic lift of 28% within 8 weeks — with no additional content investment required.

How Shopify Markets generates hreflang tags — and where it breaks

Shopify injects hreflang alternate link tags automatically through the content_for_header Liquid object, which every theme renders inside the <head> of layout/theme.liquid. When you configure a market with a specific language and assign it a domain, subfolder, or subdomain, Shopify outputs the correct language-region pair across every page on your store — automatically, within minutes of publishing.

A well-configured three-market store produces output like this on every page:

That is the ideal output. The reality for most stores is messier. Here are the five failure modes we found most often in our 47-store audit:

Nonsensical language-region combos — Shopify combines the market’s country code with whichever language is active in that market. If you have a German market but serve it in French, you get fr-DE — a tag Google ignores because it represents a near-zero audience.
Missing x-default — Shopify only outputs an x-default tag when a primary market is correctly configured. Stores that changed their primary market during a Markets migration frequently lose this tag entirely.
Alternates pointing to redirects or noindex pages — If a translated page is unpublished, password-protected, or returns a 301, the alternate becomes invalid. Google discards the entire hreflang cluster for that page.
Missing reciprocal tags — Every URL in an hreflang cluster must reference all other URLs in the cluster. A page that is referenced by others but does not include the return references breaks reciprocity and signals misconfiguration to crawlers.
Duplicate hreflang tags — If a theme or app adds its own hreflang markup on top of Shopify’s automatic output, the page ends up with two sets of conflicting annotations. Google’s documentation explicitly warns this can hurt rankings.

Understanding these failure modes is the foundation of every approach below. Before touching a single tag, enable Automatic hreflang tags under Online Store > Preferences > Social sharing and SEO — and if you plan to use a custom or app-generated solution, disable it first to prevent duplicates.

All 10 approaches to Shopify hreflang, compared at a glance

Rank	Approach	Best for	From	Rating
01	Ryze AI Hreflang Audit Winner	Autonomous continuous hreflang monitoring and fixing	Flat fee	4.9/5
02	Shopify Native Auto-Tags	Stores with clean Markets configuration	Free (built-in)	3.8/5
03	Custom theme.liquid Hreflang	Developers needing full control	Dev time	4.2/5
04	Weglot	Translation + automatic hreflang for multilingual stores	From $17/mo	4.5/5
05	Langify / Shopify Translate & Adapt	Built-in translation with hreflang sync	Free–$19/mo	4.1/5
06	Hreflang Manager Apps (e.g. SEO King)	Non-technical merchants needing tag control	From $9.99/mo	4.0/5
07	Screaming Frog + Manual Fixes	Agencies auditing and fixing client stores	From £259/yr	4.3/5
08	Google Search Console Monitoring	Catching hreflang errors post-deployment	Free	4.4/5
09	Headless Shopify + Custom Hreflang API	Enterprise stores needing cross-store alternates	Custom	4.6/5
10	Ahrefs / Semrush International Audit	Ongoing competitive hreflang benchmarking	From $99/mo	4.5/5

Get a free instant audit

Get a free, instant read on your paid ads or SEO — and fix it right away.

Paid ads audit

Catch wasted spend & broad-match leaks
Find account structure gaps
Rank your quickest wins
Spot PMax & brand-search overlap
Check conversion-tracking health
Benchmark CPC vs your industry
Catch wasted spend & broad-match leaks
Find account structure gaps
Rank your quickest wins
Spot PMax & brand-search overlap
Check conversion-tracking health
Benchmark CPC vs your industry

Free · no credit card · instant

SEO audit

Find keyword & ranking gaps
Catch technical SEO issues
Rank your fastest wins
Surface thin & duplicate pages
Check indexing & crawl coverage
Compare backlinks vs competitors
Find keyword & ranking gaps
Catch technical SEO issues
Rank your fastest wins
Surface thin & duplicate pages
Check indexing & crawl coverage
Compare backlinks vs competitors

Free · no credit card · instant

All approaches, tested and ranked

Approaches #2–#10: every method for Shopify hreflang setup across countries

02Best for stores with a clean, well-structured Markets configuration

Shopify Native Auto-Generated Hreflang Tags

Shopify’s built-in hreflang generation is the foundation every international store builds on. When you configure a market under Settings > Markets, assign it a domain or subfolder, publish translated content, and enable Automatic hreflang tags under Online Store > Preferences, Shopify begins injecting <link rel="alternate" hreflang="..."> tags into every page automatically — no code required.

The system works well when your Markets configuration is logical: one language per market, distinct language-region pairs, and a clearly designated primary market for x-default output. It breaks quietly when those conditions are not met. A UK market accidentally assigned generic "English" instead of "English (United Kingdom)" will output hreflang="en" instead of hreflang="en-gb" — and both Google and Bing will struggle to serve the UK version to British searchers. Always verify with View Source or Google’s Rich Results Test immediately after any Markets change.

PricingFree — built into every Shopify plan

ProsZero setup effort, updates automatically when markets change, stays in sync with canonical URLs, covers every page site-wide

ConsCannot be manually edited, produces nonsensical combos like fr-DE when market-language pairings are illogical, x-default missing without primary market set, no audit trail

VerdictThe right starting point for every store — but trust it blindly and you will rank in the wrong countries

03Best for developers who need precise control over every tag

Custom Hreflang in theme.liquid via Localization Object

Building your own hreflang tags in theme.liquid gives you surgical precision over every alternate tag your store outputs. You disable Shopify’s automatic generation via Online Store > Preferences, then use the localization Liquid object to loop through available markets and languages, outputting correctly structured link rel="alternate" tags dynamically. Shopify’s own documentation warns never to hardcode domains or resource handles — a collection’s handle can differ between language versions, so dynamic generation from the localization object is mandatory.

The critical risk: the moment someone re-enables Automatic hreflang tags in admin without removing the custom code, the store outputs two complete sets of conflicting annotations. Google has explicitly flagged duplicate hreflang tags as harmful to international rankings. If you use this approach, document it clearly and add a comment in theme.liquid warning future editors. For multi-store setups where you need alternates pointing across separate Shopify stores on different domains — something the Markets system cannot handle natively — this is the only viable approach. For those scenarios, see also our guide on Shopify international SEO for global markets.

PricingDeveloper time — typically $300–$2,000 as a one-time project

ProsFull control over tag output, can handle cross-store alternates, handles edge cases native output cannot, enables x-default customization

ConsMust disable native auto-tags first (risk of forgetting), breaks if someone re-enables auto-tags in admin, requires ongoing maintenance as markets change, handles only scenarios Shopify's localization object exposes

VerdictThe right call for complex multi-store or headless setups — overkill for standard Markets configurations

Why continuous monitoring beats one-time setup

Hreflang configuration is not a set-and-forget task. Every time you add a market, publish a new language, change a domain, or a translated page goes live, your hreflang cluster changes. Ryze AI monitors your entire hreflang setup 24/7 — catching broken reciprocal links, nonsensical combos, missing x-default tags, and alternates pointing to redirected URLs before Google recrawls and downgrades your international rankings. Learn more at get-ryze.ai.

04Best for multilingual stores that want translation and hreflang handled together

Weglot

Weglot is the most popular third-party translation and hreflang solution for Shopify, used by more than 70,000 websites globally. It installs via a Shopify app, automatically detects all store content, translates it using a combination of machine translation and human editing, and outputs hreflang tags that mirror its translated URL structure — subfolders by default (/fr/, /de/) or subdomains on higher plans.

The critical configuration step: if you are using Weglot alongside Shopify Markets, you must disable Shopify’s Automatic hreflang tags to avoid duplicate annotations. Weglot’s tags and Shopify’s native tags will otherwise both appear in the <head>, confusing crawlers. For stores where content localization quality matters as much as technical correctness — fashion, beauty, luxury goods — Weglot’s translation layer plus clean hreflang output is a strong combination. For stores that are only selling to different regions in the same language (US vs. UK vs. AU in English), it is overkill compared to a properly configured Shopify Markets setup.

PricingFrom $17/month (Starter, up to 10,000 words); scales to $360/month+ for large stores

ProsAutomatic hreflang injection aligned with translated URLs, visual translation editor, supports 110+ languages, SEO-friendly subdirectory and subdomain structure

ConsMonthly cost scales steeply with word count, adds a translation layer that can conflict with Shopify Markets if both are active, limited control over tag granularity

VerdictBest for stores prioritising translation quality alongside technically correct hreflang — particularly stores selling across many languages rather than just regions

05Best for stores wanting native Shopify translation with automatic hreflang sync

Shopify Translate & Adapt (+ Langify)

Shopify Translate & Adapt is Shopify’s free, native translation tool. It lets you manage translations for all store content — product descriptions, metafields, navigation, checkout — directly in the Shopify admin. Because it operates within the Markets and Languages framework, the hreflang tags it enables are exactly the ones Shopify’s auto-generation system outputs — no conflicts, no duplicates.

Langify is a veteran Shopify translation app that predates Translate & Adapt and offers more granular control, including translated URL slugs and metafields, at a paid monthly rate. Both tools share the same fundamental advantage for hreflang: they stay within Shopify’s native hreflang framework rather than introducing a parallel system. The risk they do not solve is misconfiguration at the Markets level — if your market-language pairings are wrong, these tools output the same wrong hreflang tags Shopify would produce natively. Pair either with an ongoing audit tool to catch configuration drift. For a broader look at how your translations affect organic performance, see our post on Shopify SEO audit checklist.

PricingShopify Translate & Adapt: Free. Langify: from $17.50/month

ProsNative to Shopify ecosystem, zero conflict risk with Markets auto-tags, translates metafields and custom content, works with all themes

ConsMachine translation quality is basic without manual review, Langify adds cost, neither handles cross-store alternates, limited to Shopify-managed URLs

VerdictThe pragmatic choice for stores already on Shopify Markets that want translation without introducing a conflicting third-party hreflang layer

Your international SEO, fixed on autopilot.

✓Audits hreflang tags across every market 24/7
✓Catches x-default errors and broken alternates before Google does
✓Fixes misconfigured tags and international SEO issues automatically

2,000+

Marketers

$500M+

Ad spend

Countries

06Best for non-technical merchants who need direct tag control without writing code

Hreflang Manager Apps (e.g. SEO King, Hreflang Manager)

Shopify hreflang apps fill the gap between Shopify’s automatic output and the custom development required for full theme.liquid control. Apps like SEO King, Hreflang Manager, and similar tools in the Shopify App Store provide a visual interface where merchants can define their alternate URL mappings, specify language-region codes, and generate the resulting tags — all without touching code.

The most important setup step with any of these apps: disable Shopify’s Automatic hreflang tags first. Every store we audited that reported mysterious duplicate hreflang output was running one of these apps alongside native auto-generation. The compounded error is worse than either alone — Google sees conflicting signals and may disregard the entire hreflang cluster. Used correctly (native tags off, app-generated tags on), these tools can resolve specific configuration problems quickly. Their weakness is passivity — they set tags once and do not alert you when a market change, a domain redirect, or a new language publication invalidates the configuration you set up last quarter.

PricingFrom $9.99/month (SEO King); standalone hreflang apps typically $5–$25/month

ProsVisual interface for managing alternate tags, no coding required, some apps generate XML sitemaps with hreflang, good for fixing specific tag issues quickly

ConsCan conflict with Shopify native auto-tags if both are active, app quality varies widely, most do not monitor for configuration drift, limited to single-store setups

VerdictA reasonable short-term fix for a specific hreflang problem — not a substitute for correct Markets configuration or continuous monitoring

07Best for agencies auditing and correcting hreflang across multiple client stores

Screaming Frog + Manual Fixes

Screaming Frog SEO Spider remains the most thorough way to audit hreflang implementation on any Shopify store. Its dedicated hreflang report crawls every page, extracts all alternate annotations, validates each against the four rules (correct language-region format, reciprocal references, canonical consistency, no non-200 status alternates), and exports a spreadsheet of every error by type and affected URL.

For agencies managing international Shopify clients, a Screaming Frog hreflang audit before and after any Markets reconfiguration is close to mandatory. The tool surfaces problems that are invisible in the Shopify admin — alternates pointing to 301-redirected product URLs after a handle change, x-default tags pointing to a different page than the canonical, non-reciprocal references between a German subdirectory and the root US domain. Its limitation is that it is a snapshot: crawl today, fix today, and by next month a new market or a translated collection can introduce new errors. Pair it with continuous Shopify SEO monitoring to maintain what the audit establishes.

PricingScreaming Frog SEO Spider: £259/year (licence); agency time adds to this

ProsMost thorough hreflang audit available, finds reciprocity errors, flags alternates pointing to non-200 URLs, integrates with Google Search Console, exportable reports

ConsPoint-in-time audit only — does not monitor continuously, requires technical SEO knowledge to interpret results, manual fix implementation is slow

VerdictThe gold standard for a one-time hreflang audit — every international Shopify store should run one, but it is not a substitute for ongoing automated monitoring

08Best for catching and diagnosing hreflang errors after deployment

Google Search Console Hreflang Error Monitoring

Google Search Console reports on your hreflang implementation under the International Targeting report (Legacy Tools and Reports section). It categorizes errors by type: no return tag (reciprocity failure), invalid hreflang tag value (malformed language-region code), inconsistent language, and unknown language. Each error type links to the affected URLs and explains what Google found.

The practical value of GSC for hreflang is that it reflects Google’s actual processing of your tags — not just what appears in your HTML. A tag might look syntactically correct in View Source but still generate a no-return-tag error if the alternate page it references does not include a matching back-reference. For Shopify stores using subfolder-based Markets, the International Targeting report also lets you set a target country for the root domain — an additional signal that complements (but does not replace) hreflang. Treat GSC as your confirmation layer, not your discovery layer. For an overview of all the SEO data signals worth monitoring, see our Shopify SEO audit checklist.

PricingFree

ProsDirectly shows how Google processes your hreflang tags, reports specific error types (no-return-tag, invalid language code, inconsistent language), free and always on

ConsReactive — only shows errors after Google crawls the page (can take days to weeks), does not suggest fixes, does not show Bing or other search engine processing

VerdictEssential and free — every international Shopify store should verify hreflang health in Search Console weekly, but it should supplement rather than replace proactive monitoring

09Best for enterprise stores needing cross-store hreflang alternates or fully custom URL structures

Headless Shopify + Custom Hreflang API

Headless Shopify with custom hreflang generation is the most powerful — and most expensive — approach. In a headless setup, your frontend (typically Next.js, Nuxt, or a similar framework) fetches product and page data from Shopify’s Storefront API and renders it independently. Because the <head> is entirely under your control, hreflang tags can be generated precisely from a central configuration that spans multiple Shopify stores, multiple domains, and any URL structure you define.

This is the only viable approach for an international brand running separate Shopify stores per region (e.g., shopify-us.com, shopify-de.com, shopify-fr.com) that needs cross-store hreflang alternates — a scenario Shopify Markets cannot handle natively, as its hreflang output only spans markets within a single store. Shopify’s own developer documentation confirms that custom tags are appropriate for “linking alternate versions of a page across separate Shopify stores on different domains.” For most stores, however, the complexity and cost dwarf the benefit. Consolidating to a single Shopify Markets setup and fixing the native hreflang configuration is faster, cheaper, and produces equivalent results.

PricingCustom — enterprise Shopify plans plus significant development investment

ProsComplete flexibility over hreflang output, supports cross-store alternates, handles complex scenarios Markets cannot (e.g., separate stores per region on different TLDs), integrates with any CMS or frontend

ConsExtremely high implementation cost, requires ongoing engineering resources, Shopify's native hreflang system is not available — you own all tag generation entirely

VerdictThe right architecture for large international retailers with dedicated engineering teams and multi-store regional strategies — expensive overkill for most stores

10Best for benchmarking hreflang health against competitors and ongoing international SEO reporting

Ahrefs / Semrush International Hreflang Auditing

Ahrefs and Semrush both include hreflang auditing within their site audit modules — Ahrefs flags hreflang errors including missing return tags and invalid codes, while Semrush’s International SEO report cross-references your hreflang configuration with organic visibility data per country. The key advantage over standalone crawlers is context: you can see that your German market has three hreflang errors and simultaneously see that your German organic traffic dropped 22% last month — making the connection between technical configuration and revenue impact explicit.

Neither tool implements fixes, and neither monitors in real time — both run scheduled crawls on weekly or monthly cycles, which is too slow to catch hreflang configuration drift introduced by a Markets change mid-month. For competitive benchmarking and executive reporting on international SEO health, they are excellent. For the actual work of keeping hreflang correct across a changing Shopify Markets setup, they are best used alongside an automated monitoring tool. For more on how international organic visibility connects to paid traffic strategy, see our guide on connecting AI to Google and Meta Ads for international campaigns.

PricingAhrefs: from $99/month. Semrush: from $99/month.

ProsCross-references hreflang with organic ranking data, shows which international pages are gaining or losing visibility, competitor hreflang gap analysis, integrated with broader SEO reporting

ConsSite audit hreflang reports are less granular than Screaming Frog, monthly cost is significant, does not implement fixes — purely analytical

VerdictBest as the strategic layer for international SEO — pair with Screaming Frog for technical audits and Ryze AI for automated fixes to build a complete monitoring stack

Dominic S.

International SEO Lead
DTC Apparel Brand

★★★★★

“

We had hreflang tags live across six Shopify Markets and had no idea that three of them had no-return-tag errors. Ryze caught the misconfiguration in the first audit and fixed it. Our German market went from basically invisible to page two in six weeks.”

+28%

International organic lift

6 weeks

Time to result

Markets fixed

How do you choose the right hreflang setup for your Shopify Markets configuration?

With 10 approaches ranging from free native auto-generation to enterprise headless setups, the right choice depends on three variables: the complexity of your Markets configuration, your team’s technical capacity, and whether you need ongoing monitoring or just an initial implementation.

Decision 1

How complex is your Shopify Markets setup?

One or two markets, single language each: Shopify native auto-tags plus a one-time Screaming Frog audit to verify
Three to eight markets, multiple languages: Shopify native auto-tags configured correctly, Ryze AI for ongoing monitoring, GSC for confirmation
Multiple languages per market or unusual combos: Custom theme.liquid implementation with native auto-tags disabled
Separate Shopify stores per region on different domains: Headless Shopify with custom hreflang API — the only approach that handles cross-store alternates

Decision 2

What is your team's technical level?

Non-technical merchant: Shopify native auto-tags plus Weglot or Translate & Adapt for translation, Ryze AI for monitoring
Marketing team with some SEO knowledge: Native auto-tags, GSC monitoring, Screaming Frog quarterly audit, hreflang app for specific fixes
In-house developer or agency: Custom theme.liquid implementation for precision, Ahrefs or Semrush for strategic reporting
Enterprise engineering team: Headless architecture with custom hreflang generation, full control over every tag

Decision 3

Do you need ongoing monitoring or a one-time fix?

One-time fix for a known issue: Screaming Frog audit plus manual implementation or a hreflang app
Ongoing monitoring as markets evolve: Ryze AI for automated hreflang health tracking and fixes 24/7
Strategic international SEO reporting: Ahrefs or Semrush international audit paired with a technical monitoring layer
All of the above: Correctly configured Shopify Markets (clean language-region pairs, primary market set) + Ryze AI continuous audit + GSC confirmation + quarterly Screaming Frog crawl

The bottom line: For most Shopify stores selling across two or more countries, the right answer is Shopify’s native auto-tags configured correctly (clean language-region pairs, a designated primary market, and no competing hreflang sources active simultaneously), combined with Ryze AI for continuous monitoring that catches configuration drift before Google does. For large international stores with separate regional domains or headless architectures, custom implementation plus enterprise SEO tooling is worth the investment. Whatever approach you choose, run a Screaming Frog audit after every significant Markets change — and check Google Search Console’s International Targeting report weekly.

Step-by-step: configuring hreflang for Shopify Markets correctly in 2026

Follow these eight steps in order for any new international market launch or hreflang remediation project. Each step includes the specific Shopify admin path and the validation check that confirms it is working.

Step 1

Audit your current hreflang output

Before changing anything, run a Screaming Frog crawl or use View Source on three representative pages (home, a collection, a product) to capture the hreflang tags currently being output. Save this as your baseline. Check for duplicate tags (two sets of alternates), nonsensical language-region combos, and missing x-default.

Step 2

Check Online Store > Preferences for the auto-tag setting

Navigate to Online Store > Preferences > Social sharing and SEO. Confirm whether Automatic hreflang tags is on or off. If you are using native auto-generation, it should be ON. If you are using Weglot, a hreflang app, or custom theme.liquid code, it must be OFF. A mismatch is the most common source of duplicate-tag problems.

Step 3

Verify your Markets language-region configuration

Go to Settings > Markets. For each market, click the market name and then Languages. Every market should have exactly one default language, and that language should be the region-specific variant — English (United Kingdom) for a UK market, not generic English. If you see generic language assignments, change them to the region-specific version. This is what determines the language-region code in your hreflang output.

Step 4

Confirm your primary market and x-default

In Settings > Markets, one market should be designated as the primary market. This is the market whose URL Shopify will use for the x-default hreflang tag. If no primary market is set — a common problem after Markets migrations — x-default will be missing from your output. Set the primary market explicitly, then verify x-default appears in View Source.

Step 5

Assign distinct domains, subfolders, or subdomains to each market

Each market needs its own URL structure for hreflang to function. Go to Settings > Markets > [Market Name] > Domains and assign either a dedicated top-level domain (store.co.uk), a subfolder (/en-gb/), or a subdomain (uk.store.com). Markets sharing the same root domain with no subfolder differentiation cannot produce valid hreflang output because there is no distinct URL for the alternate tag to reference.

Step 6

Publish translated content for every market

Hreflang tags for a market are only valid if the alternate URL they reference returns a 200 status and is indexable. Go to Online Store > Themes > Edit languages and confirm that published translations exist for every market you have configured. Any market with unpublished or incomplete translations will produce alternate tags pointing to non-functional URLs — invalidating the entire hreflang cluster for affected pages.

Step 7

Validate with Google's Rich Results Test and Screaming Frog

Once your configuration is live, validate it using Google's Rich Results Test (search.google.com/test/rich-results) on your home page, a collection page, and a product page. This shows the page as Google sees it, including hreflang tags. Then run a full Screaming Frog hreflang audit to check for reciprocity errors and alternates pointing to non-200 URLs across the full site.

Step 8

Monitor continuously — configuration changes break hreflang silently

Every time you add a market, change a language, update a domain, publish new content, or run a theme update, your hreflang configuration can change. Set up weekly Google Search Console checks of the International Targeting report and use an automated tool like Ryze AI to catch configuration drift between manual audit cycles. Hreflang is not a one-time task — it is an ongoing operational responsibility for any internationally trading store.

1,000+ marketers use Ryze

Automating hundreds of agencies

★★★★★4.9/5

Frequently asked questions about hreflang setup for Shopify Markets across countries

Does Shopify automatically add hreflang tags for international markets?

Yes — Shopify Markets injects hreflang alternate link tags for every published market through the content_for_header Liquid object. You get language-only tags like hreflang="en" and language-region tags like hreflang="en-gb" automatically once you assign a domain or subfolder to each market and publish translated content. The gaps are x-default (only output when a primary market is correctly configured) and tag accuracy when market-language pairings are illogical — e.g., a French-language market assigned to Germany producing fr-DE.

What is x-default hreflang and do Shopify stores need it?

The x-default hreflang tag tells search engines which page to show to visitors from countries you do not explicitly serve, or users whose browser language preference does not match any of your markets. Every international Shopify store needs one. Shopify outputs x-default automatically when a primary market is set. If your x-default tag is missing — common after Markets migrations — go to Settings > Markets and designate a primary market explicitly.

How do I fix nonsensical hreflang combinations like fr-DE in Shopify Markets?

This happens when Shopify combines a market's country code with the language active in that market — in this case, French as the language of a German market. Fix it by going to Settings > Markets > [Market Name] > Languages and changing the language assignment to the German-region language (de-DE) rather than French. Each market should have a language that logically matches its country — English (United Kingdom) for a UK market, French (France) for a French market. If you need to serve French content in Germany, consider whether a separate French-Germany market with a distinct URL is the right structure, or whether a broader French-language market covering all French-speaking regions makes more sense.

Can I manually edit hreflang tags in Shopify without touching theme.liquid?

Not through the Shopify admin — there is no native interface for editing individual hreflang tags. Your options are: correct the underlying Markets configuration so Shopify's auto-generation produces the right output (preferred), use a Shopify hreflang app that provides a visual interface for tag management (requires disabling native auto-tags first), or edit layout/theme.liquid directly using the localization Liquid object (requires disabling native auto-tags and ongoing developer maintenance). Never add custom hreflang tags on top of Shopify's automatic output — the resulting duplicates can harm your international rankings.

How do I verify my Shopify hreflang tags are working correctly?

Use four verification methods in this order: (1) View Source in a browser on three page types (home, collection, product) and check the head for link rel="alternate" hreflang tags. (2) Google's Rich Results Test (search.google.com/test/rich-results) to see the page as Googlebot sees it, including hreflang. (3) Screaming Frog SEO Spider's hreflang report for a full-site audit of reciprocity, valid language codes, and non-200 alternates. (4) Google Search Console's International Targeting report (Legacy Tools) for error categorization based on Google's actual processing of your tags.

What happens to hreflang if I add a new Shopify Market?

When you publish a new market in Shopify and assign it a language and a domain or subfolder, Shopify automatically adds the new alternate tag to every page on your store — usually within minutes. However, the new market's pages need to be published and indexable for the alternate to be valid. Check that translated content is live (not draft), that the market's domain or subfolder is correctly configured, and that no noindex tags are applied to the market's pages. Run a fresh Screaming Frog audit after any market addition to confirm the new alternates are reciprocal and all existing clusters remain intact.

Fix your Shopify hreflang automatically

#1 of 10 · flat fee · free trial