Ecommerce Development

Shopify Hreflang Setup: How to Tell Google Which Language Version to Show Each Country

Shopify Hreflang Setup: How to Tell Google Which Language Version to Show Each Country

Learn how to set up hreflang correctly on Shopify for multi-language and multi-regional stores. Avoid duplicate content penalties, fix common configuration errors, and ensure Google surfaces the right version to the right audience.

Learn how to set up hreflang correctly on Shopify for multi-language and multi-regional stores. Avoid duplicate content penalties, fix common configuration errors, and ensure Google surfaces the right version to the right audience.

08 min read

If your Shopify store serves customers across multiple countries or languages, there is a good chance Google is not showing the right version to the right audience — and you may not even know it. Hreflang is the mechanism that tells search engines which language or regional variant of a page to surface for a specific user. Without it, your English-India page might rank in Germany, your French version might cannibalise your English traffic, and your SEO equity gets split across duplicates instead of consolidated where it should be. This is one of the most technically mishandled areas of international Shopify SEO, partly because the platform has changed how it handles internationalisation significantly over the past few years, and partly because most guides either oversimplify the setup or skip the parts that actually fail in practice. This post covers the full picture — what hreflang is, how Shopify handles it natively, where the gaps are, and how to implement it correctly so Google shows the right page to the right person in every market. Mastering this configuration is a prerequisite for any D2C brand intending to maintain healthy organic growth across borders, as it prevents the algorithmic confusion that often plagues rapidly scaling stores. By aligning your technical signals with your business strategy, you ensure that high-intent traffic from specific regions is routed to the checkout experience that best matches their localized currency, language, and shipping expectations, thereby directly influencing your conversion rates and overall regional customer lifetime value.

What Hreflang Is and Why Shopify Stores Get It Wrong

Hreflang is an HTML attribute that signals to search engines the language and optional regional targeting of a page, and then points to all the equivalent versions across other languages or regions. It is not a redirect. It does not change what users see when they land on the page. It is a signal for crawlers — specifically for Google and Yandex — that tells them which version of a page should rank for which audience. A page targeting English speakers in India should carry a hreflang tag pointing to itself as en-IN, and it should also carry tags pointing to every other language or regional variant of that page across the site. This granular control is essential because search engines lack the cultural context to assume which market a specific user resides in based solely on IP addresses or browser settings. Without these tags, crawlers will inevitably encounter identical or near-identical content translated into different dialects, which triggers internal competition and potential "duplicate content" flags. This dilution of authority is particularly damaging to smaller or mid-sized stores that rely heavily on consolidated ranking signals to compete with larger, more established retailers in competitive international search result pages.

The reason Shopify stores get this wrong is structural. Shopify generates storefronts dynamically, and the way URLs are structured for multiple languages depends heavily on which internationalisation approach the store is using. Older stores use third-party translation apps that create subfolders or subdomains with inconsistent tag implementations. Newer stores using Shopify Markets generate automatic hreflang tags in some cases, but the coverage is incomplete and does not always extend to custom templates, collection pages, or metaobject-driven content. Developers often assume the platform handles it natively and do not audit the output, which means the tags are either missing, malformed, or pointing to pages that return non-200 status codes. This gap frequently occurs because theme developers prioritize visual aesthetic and front-end performance over the specific, often hidden, metadata requirements of global SEO, leading to a disconnect between what the store displays to the user and what the search engine actually perceives during the indexing process.

How Shopify Markets Handles Hreflang Natively

Shopify Markets is the platform's built-in internationalisation infrastructure. When a store enables multiple markets and assigns separate language and currency configurations to each, Shopify will automatically generate hreflang tags on core storefront pages including the homepage, product pages, and collection pages. The language is encoded in the URL structure as a subfolder — for example, a French-language store on a .com domain would generate URLs like yourdomain.com/fr-fr/ for the French-France market. This native integration is a significant step forward for the platform, reducing the reliance on external SEO apps that historically caused conflicts by injecting competing tags into the head of the document. By centralizing the management of these locale-specific URLs within the Shopify administrative panel, store operators can ensure that the structural URL mapping is consistent with the backend market settings, theoretically creating a seamless experience for crawlers that is inherently aligned with the site's primary directory structure.

The automatic implementation is reasonably solid for standard Liquid templates. However, there are important gaps that operators need to understand before assuming the setup is complete. First, hreflang tags generated by Shopify Markets are typically injected into the page head through the theme's layout file. If you are using a custom or heavily modified theme, this injection may be missing or overridden. Second, pages built using Online Store 2.0 sections or third-party app blocks do not always inherit the correct hreflang logic. Third, blog posts and custom pages created through the Pages editor may not receive correctly formed hreflang tags depending on the theme's architecture. Fourth, if you are using a translation app such as Weglot, Langify, or Transcy alongside Shopify Markets, there is a real risk of duplicate or conflicting hreflang tag sets being generated, which can confuse Google rather than helping it. These inconsistencies often stem from the interaction between the theme's core code and the diverse array of applications installed on the store, creating a scenario where two different systems attempt to act as the "source of truth" for the site's global SEO, ultimately causing Google to disregard the conflicting signals entirely.

The Shopify Hreflang Readiness Checklist

The Shopify Hreflang Readiness Checklist is a structured audit framework for evaluating whether a Shopify store's internationalisation setup is configured correctly from a search visibility standpoint. It covers the five signal areas that most commonly fail in multi-market Shopify deployments. Run through this checklist on any store before launching a new market or after migrating from an older translation infrastructure to Shopify Markets. This proactive auditing process is essential for mitigating the risk of long-term organic traffic decline, which often happens when a store expands its global footprint without properly securing the underlying tag architecture first. By verifying these signals, technical operators can feel confident that every page index represents a deliberate attempt to capture specific regional search intent, rather than a fragmented, messy deployment that ultimately hurts the brand's reputation with search engines.

Signal One — Tag Presence

Verify that hreflang tags are present in the head section of every page type that is being indexed across multiple markets. This includes the homepage, product pages, collection pages, blog posts, and any custom landing pages. Use a tool like Screaming Frog or Ahrefs' site audit to crawl the store and flag pages where hreflang tags are absent. A store with 400 products and four languages should have hreflang tags present on all 1,600 product page variants. The verification step is critical because simply assuming the tags are working based on a cursory look at the homepage is dangerous; complex stores often suffer from partial implementation, where only a subset of URL templates are correctly tagged, leaving the rest of the site vulnerable to indexing issues.

Signal Two — Bidirectional References

Every hreflang tag implementation must be bidirectional. If your English-US page references your English-UK page using a hreflang tag, the English-UK page must also reference the English-US page with a corresponding tag pointing back. This is a requirement, not a recommendation. Pages that reference other variants without receiving a reciprocal reference create an incomplete signal that Google will either ignore or interpret as an error. Shopify Markets does handle this automatically for standard pages, but custom-built or app-generated pages often break the chain. Ensuring reciprocity is the most common hurdle for developers, as it requires a high degree of precision in mapping every variant to its siblings, ensuring no broken or circular references are introduced during the deployment phase.

Signal Three — x-default Tag

Every hreflang implementation should include an x-default tag pointing to the fallback page — the version that should be shown to users who do not match any of the specific language or region targets. For most Shopify stores, this will be the primary English storefront. The x-default tag must be consistent across all page variants in the set. If it is missing or pointing to a page that redirects, Google may fail to resolve the correct fallback for unmatched users. This tag effectively serves as a safety net, guaranteeing that even if a user arrives from an unsupported location or uses a language/region pairing that you haven't explicitly localized, they are still served the most relevant default version rather than landing on a generic 404 or an irrelevant error page.

Signal Four — Canonical Alignment

Hreflang tags and canonical tags must not contradict each other. A page that carries a hreflang tag marking it as the primary version for a given locale should also have a self-referencing canonical tag. If the canonical tag on a regional variant points to a different page — such as the English default — Google will prioritise the canonical signal and may ignore the hreflang instruction entirely. This is one of the most common causes of international pages failing to rank in their target market. When signals conflict, Google's algorithm is designed to choose the most reliable path; because canonicals are treated as a stronger signal for page identity, a misaligned canonical will always override a carefully constructed hreflang set, rendering your international efforts moot.

Signal Five — URL Validity

Every URL referenced inside a hreflang tag must return a 200 status code and be indexable. If a page has been deleted, moved, or blocked by robots.txt, and a hreflang tag still references the old URL, Google will discount the entire tag set for that page cluster. Run a validation pass on all hreflang-referenced URLs as part of any international SEO audit, particularly after store migrations or market restructuring. Maintaining this "hygiene" is an ongoing operational task, as stale references can quickly accumulate whenever product lines are discontinued, marketing landing pages are retired, or site architectures are reorganized, leading to a degradation of your global indexing quality.

How to Implement Hreflang on Shopify — Step by Step

Step 1: Audit your current internationalisation setup. Before adding or modifying any hreflang tags, establish a clear picture of your current architecture. Identify which internationalisation method your store is using — Shopify Markets, a third-party translation app, subdomain routing, or a combination. Document the URL structure for each language or region variant. Crawl the live store using Screaming Frog with hreflang extraction enabled, and export the full hreflang tag report. This gives you a baseline of what is currently implemented, where tags are missing, and where conflicts exist between different systems generating hreflang output simultaneously. By documenting the entire site tree at the start of the project, you create a source of truth that allows you to identify precisely which templates are broken and which are healthy, preventing the accidental "over-tagging" that happens when multiple systems attempt to solve the same problem.

Step 2: Configure Shopify Markets correctly for each target region. Inside the Shopify admin, navigate to Settings and then Markets. Ensure each active market has a distinct domain or subfolder configured, with the correct language assigned. If you are targeting English speakers in both the US and India as separate markets, each needs its own market configuration with the appropriate locale code. Do not use the same language code for two different regional targets without a region suffix — en on its own will not differentiate between English-US and English-IN in the hreflang output. Use en-US and en-IN specifically. This specificity is mandatory for search engines to distinguish between the nuanced regional content, as failing to provide accurate locale codes forces Google to guess your intent, often resulting in lower-quality rankings or the total suppression of the regional variant in its respective local SERPs.

Step 3: Verify hreflang injection in your theme layout file. Open your theme code and locate the layout/theme.liquid file. Find the section that renders the page head. Shopify Markets injects hreflang tags through a system render tag. Confirm this tag is present and has not been accidentally removed or commented out during theme customisation. If your theme uses a custom header partial, the hreflang injection may need to be added to that partial file instead. Use the preview mode to view the page source of your homepage and a product page in each language variant, and confirm the hreflang tags are appearing correctly in the rendered HTML. Validating the code directly in the browser's rendered output is the only way to be 100% certain that your liquid code is actually outputting the correct string to the DOM, effectively bypassing the confusion caused by complex theme files that might otherwise appear correct in the editor but fail during runtime.

Step 4: Handle translation apps and custom pages separately. If you are using a third-party translation app alongside Shopify Markets, check whether the app is generating its own hreflang tags. If it is, you will need to disable one of the two sources to avoid duplication. Most reputable translation apps have settings that allow you to disable their hreflang output when the store is already using Shopify Markets. For custom pages and blog posts that are not covered by the automatic Shopify Markets injection, you will need to add hreflang tags manually through the page template or through a custom Liquid snippet that generates the correct tag set based on the page's locale and its equivalent URLs. This requires a developer-led approach to ensure that your custom logic respects the hierarchy of the Shopify Markets structure while providing the necessary coverage for the unique, non-standard templates that the native platform fails to automatically index with appropriate metadata.

Step 5: Validate the full implementation before indexing new markets. Before submitting a new market's pages to Google Search Console for indexing, run a full validation pass. Use Google's Rich Results Test or fetch the page directly in Google Search Console to confirm the hreflang tags are appearing in the rendered output, not just in the source HTML. Check that all bidirectional references are intact. Confirm the x-default tag is present and pointing to the correct URL. Verify that canonical tags on regional pages are self-referencing and not pointing to the primary English version. Once the validation is clean, submit the sitemap for the new market in Google Search Console and request indexing for priority pages. Following this rigorous sequence of post-deployment validation ensures that your initial indexing push is clean, preventing the long-term indexing bloat that occurs when Google starts crawling and caching improperly tagged, "incorrect" variants that you then have to manually clean up within the Search Console environment.

Common Mistakes in Shopify Hreflang Setup

The following mistakes appear repeatedly in international Shopify stores that are underperforming in their target markets. Most of them are not visible to the operators running the stores because they require crawling and tag-level inspection to identify. By proactively avoiding these pitfalls, you can bypass the common architectural failures that plague most international expansion attempts, ensuring that your technical foundation remains robust throughout your period of scaling. These errors are not merely inconveniences; they are structural faults that, left unaddressed, will cause your search performance to plateau or decline even as you add high-quality content to your international storefronts.

  • Conflicting Source Tags: Using a third-party translation app and Shopify Markets simultaneously without disabling hreflang output from one source, resulting in conflicting or duplicate tag sets on the same page.

  • Redirecting Targets: Setting hreflang tags to point to URLs that redirect to a different URL, which invalidates the tag and forces Google to make its own decision about which version to rank.

  • Omitted Fallback: Failing to include the x-default tag, leaving Google without a clear fallback instruction for users who do not match any specific locale target.

  • Ambiguous Language Codes: Using language-only codes such as en or fr when the store targets different regions within the same language, such as English for India and English for the UK, which prevents Google from differentiating between the two.

  • Noindex Conflicts: Adding hreflang tags to pages that have noindex directives, which creates a contradiction — Google cannot index a page and simultaneously use it as a hreflang reference.

  • Disconnected Signaling: Implementing hreflang through a sitemap but not in the page head, then using a theme that generates conflicting or absent hreflang in the HTML, creating inconsistency between the two signal sources.

  • Broken References: Not updating hreflang references after deleting or redirecting regional pages, leaving broken references that degrade the entire tag cluster.

Hreflang via HTML vs Sitemap — Which Approach Works Better for Shopify

Hreflang can be implemented in three ways: in the HTML head of each page, in the XML sitemap, or via HTTP headers for non-HTML files. For Shopify stores, the relevant choice is between HTML injection and sitemap implementation. Each has trade-offs that matter depending on the size and architecture of the store. Choosing the correct approach depends heavily on your store's engineering resources and whether you intend to maintain a standard Shopify theme or move toward a more complex, headless architecture. While HTML injection is the standard recommendation for the vast majority of merchants, the sitemap route offers a cleaner, more scalable path for enterprises managing massive, custom-built product catalogs where page-level head injection is technically difficult to maintain at scale.

Approach

How It Works

Best For

Key Limitation

HTML Head Injection

Tags added directly to the page head via theme.liquid

Stores under 10,000 pages, Shopify Markets native setup

Requires theme access; may conflict with translation apps

XML Sitemap Implementation

Hreflang added to each URL entry in the sitemap

Large catalogues, headless Shopify, custom build environments

Shopify's native sitemap does not support hreflang natively; requires a custom sitemap solution

Third-Party App

App generates and manages hreflang logic

Non-technical operators, stores using translation apps

App quality varies significantly; risk of conflicts with Shopify Markets


If your Shopify store serves customers across multiple countries or languages, there is a good chance Google is not showing the right version to the right audience — and you may not even know it. Hreflang is the mechanism that tells search engines which language or regional variant of a page to surface for a specific user. Without it, your English-India page might rank in Germany, your French version might cannibalise your English traffic, and your SEO equity gets split across duplicates instead of consolidated where it should be. This is one of the most technically mishandled areas of international Shopify SEO, partly because the platform has changed how it handles internationalisation significantly over the past few years, and partly because most guides either oversimplify the setup or skip the parts that actually fail in practice. This post covers the full picture — what hreflang is, how Shopify handles it natively, where the gaps are, and how to implement it correctly so Google shows the right page to the right person in every market. Mastering this configuration is a prerequisite for any D2C brand intending to maintain healthy organic growth across borders, as it prevents the algorithmic confusion that often plagues rapidly scaling stores. By aligning your technical signals with your business strategy, you ensure that high-intent traffic from specific regions is routed to the checkout experience that best matches their localized currency, language, and shipping expectations, thereby directly influencing your conversion rates and overall regional customer lifetime value.

What Hreflang Is and Why Shopify Stores Get It Wrong

Hreflang is an HTML attribute that signals to search engines the language and optional regional targeting of a page, and then points to all the equivalent versions across other languages or regions. It is not a redirect. It does not change what users see when they land on the page. It is a signal for crawlers — specifically for Google and Yandex — that tells them which version of a page should rank for which audience. A page targeting English speakers in India should carry a hreflang tag pointing to itself as en-IN, and it should also carry tags pointing to every other language or regional variant of that page across the site. This granular control is essential because search engines lack the cultural context to assume which market a specific user resides in based solely on IP addresses or browser settings. Without these tags, crawlers will inevitably encounter identical or near-identical content translated into different dialects, which triggers internal competition and potential "duplicate content" flags. This dilution of authority is particularly damaging to smaller or mid-sized stores that rely heavily on consolidated ranking signals to compete with larger, more established retailers in competitive international search result pages.

The reason Shopify stores get this wrong is structural. Shopify generates storefronts dynamically, and the way URLs are structured for multiple languages depends heavily on which internationalisation approach the store is using. Older stores use third-party translation apps that create subfolders or subdomains with inconsistent tag implementations. Newer stores using Shopify Markets generate automatic hreflang tags in some cases, but the coverage is incomplete and does not always extend to custom templates, collection pages, or metaobject-driven content. Developers often assume the platform handles it natively and do not audit the output, which means the tags are either missing, malformed, or pointing to pages that return non-200 status codes. This gap frequently occurs because theme developers prioritize visual aesthetic and front-end performance over the specific, often hidden, metadata requirements of global SEO, leading to a disconnect between what the store displays to the user and what the search engine actually perceives during the indexing process.

How Shopify Markets Handles Hreflang Natively

Shopify Markets is the platform's built-in internationalisation infrastructure. When a store enables multiple markets and assigns separate language and currency configurations to each, Shopify will automatically generate hreflang tags on core storefront pages including the homepage, product pages, and collection pages. The language is encoded in the URL structure as a subfolder — for example, a French-language store on a .com domain would generate URLs like yourdomain.com/fr-fr/ for the French-France market. This native integration is a significant step forward for the platform, reducing the reliance on external SEO apps that historically caused conflicts by injecting competing tags into the head of the document. By centralizing the management of these locale-specific URLs within the Shopify administrative panel, store operators can ensure that the structural URL mapping is consistent with the backend market settings, theoretically creating a seamless experience for crawlers that is inherently aligned with the site's primary directory structure.

The automatic implementation is reasonably solid for standard Liquid templates. However, there are important gaps that operators need to understand before assuming the setup is complete. First, hreflang tags generated by Shopify Markets are typically injected into the page head through the theme's layout file. If you are using a custom or heavily modified theme, this injection may be missing or overridden. Second, pages built using Online Store 2.0 sections or third-party app blocks do not always inherit the correct hreflang logic. Third, blog posts and custom pages created through the Pages editor may not receive correctly formed hreflang tags depending on the theme's architecture. Fourth, if you are using a translation app such as Weglot, Langify, or Transcy alongside Shopify Markets, there is a real risk of duplicate or conflicting hreflang tag sets being generated, which can confuse Google rather than helping it. These inconsistencies often stem from the interaction between the theme's core code and the diverse array of applications installed on the store, creating a scenario where two different systems attempt to act as the "source of truth" for the site's global SEO, ultimately causing Google to disregard the conflicting signals entirely.

The Shopify Hreflang Readiness Checklist

The Shopify Hreflang Readiness Checklist is a structured audit framework for evaluating whether a Shopify store's internationalisation setup is configured correctly from a search visibility standpoint. It covers the five signal areas that most commonly fail in multi-market Shopify deployments. Run through this checklist on any store before launching a new market or after migrating from an older translation infrastructure to Shopify Markets. This proactive auditing process is essential for mitigating the risk of long-term organic traffic decline, which often happens when a store expands its global footprint without properly securing the underlying tag architecture first. By verifying these signals, technical operators can feel confident that every page index represents a deliberate attempt to capture specific regional search intent, rather than a fragmented, messy deployment that ultimately hurts the brand's reputation with search engines.

Signal One — Tag Presence

Verify that hreflang tags are present in the head section of every page type that is being indexed across multiple markets. This includes the homepage, product pages, collection pages, blog posts, and any custom landing pages. Use a tool like Screaming Frog or Ahrefs' site audit to crawl the store and flag pages where hreflang tags are absent. A store with 400 products and four languages should have hreflang tags present on all 1,600 product page variants. The verification step is critical because simply assuming the tags are working based on a cursory look at the homepage is dangerous; complex stores often suffer from partial implementation, where only a subset of URL templates are correctly tagged, leaving the rest of the site vulnerable to indexing issues.

Signal Two — Bidirectional References

Every hreflang tag implementation must be bidirectional. If your English-US page references your English-UK page using a hreflang tag, the English-UK page must also reference the English-US page with a corresponding tag pointing back. This is a requirement, not a recommendation. Pages that reference other variants without receiving a reciprocal reference create an incomplete signal that Google will either ignore or interpret as an error. Shopify Markets does handle this automatically for standard pages, but custom-built or app-generated pages often break the chain. Ensuring reciprocity is the most common hurdle for developers, as it requires a high degree of precision in mapping every variant to its siblings, ensuring no broken or circular references are introduced during the deployment phase.

Signal Three — x-default Tag

Every hreflang implementation should include an x-default tag pointing to the fallback page — the version that should be shown to users who do not match any of the specific language or region targets. For most Shopify stores, this will be the primary English storefront. The x-default tag must be consistent across all page variants in the set. If it is missing or pointing to a page that redirects, Google may fail to resolve the correct fallback for unmatched users. This tag effectively serves as a safety net, guaranteeing that even if a user arrives from an unsupported location or uses a language/region pairing that you haven't explicitly localized, they are still served the most relevant default version rather than landing on a generic 404 or an irrelevant error page.

Signal Four — Canonical Alignment

Hreflang tags and canonical tags must not contradict each other. A page that carries a hreflang tag marking it as the primary version for a given locale should also have a self-referencing canonical tag. If the canonical tag on a regional variant points to a different page — such as the English default — Google will prioritise the canonical signal and may ignore the hreflang instruction entirely. This is one of the most common causes of international pages failing to rank in their target market. When signals conflict, Google's algorithm is designed to choose the most reliable path; because canonicals are treated as a stronger signal for page identity, a misaligned canonical will always override a carefully constructed hreflang set, rendering your international efforts moot.

Signal Five — URL Validity

Every URL referenced inside a hreflang tag must return a 200 status code and be indexable. If a page has been deleted, moved, or blocked by robots.txt, and a hreflang tag still references the old URL, Google will discount the entire tag set for that page cluster. Run a validation pass on all hreflang-referenced URLs as part of any international SEO audit, particularly after store migrations or market restructuring. Maintaining this "hygiene" is an ongoing operational task, as stale references can quickly accumulate whenever product lines are discontinued, marketing landing pages are retired, or site architectures are reorganized, leading to a degradation of your global indexing quality.

How to Implement Hreflang on Shopify — Step by Step

Step 1: Audit your current internationalisation setup. Before adding or modifying any hreflang tags, establish a clear picture of your current architecture. Identify which internationalisation method your store is using — Shopify Markets, a third-party translation app, subdomain routing, or a combination. Document the URL structure for each language or region variant. Crawl the live store using Screaming Frog with hreflang extraction enabled, and export the full hreflang tag report. This gives you a baseline of what is currently implemented, where tags are missing, and where conflicts exist between different systems generating hreflang output simultaneously. By documenting the entire site tree at the start of the project, you create a source of truth that allows you to identify precisely which templates are broken and which are healthy, preventing the accidental "over-tagging" that happens when multiple systems attempt to solve the same problem.

Step 2: Configure Shopify Markets correctly for each target region. Inside the Shopify admin, navigate to Settings and then Markets. Ensure each active market has a distinct domain or subfolder configured, with the correct language assigned. If you are targeting English speakers in both the US and India as separate markets, each needs its own market configuration with the appropriate locale code. Do not use the same language code for two different regional targets without a region suffix — en on its own will not differentiate between English-US and English-IN in the hreflang output. Use en-US and en-IN specifically. This specificity is mandatory for search engines to distinguish between the nuanced regional content, as failing to provide accurate locale codes forces Google to guess your intent, often resulting in lower-quality rankings or the total suppression of the regional variant in its respective local SERPs.

Step 3: Verify hreflang injection in your theme layout file. Open your theme code and locate the layout/theme.liquid file. Find the section that renders the page head. Shopify Markets injects hreflang tags through a system render tag. Confirm this tag is present and has not been accidentally removed or commented out during theme customisation. If your theme uses a custom header partial, the hreflang injection may need to be added to that partial file instead. Use the preview mode to view the page source of your homepage and a product page in each language variant, and confirm the hreflang tags are appearing correctly in the rendered HTML. Validating the code directly in the browser's rendered output is the only way to be 100% certain that your liquid code is actually outputting the correct string to the DOM, effectively bypassing the confusion caused by complex theme files that might otherwise appear correct in the editor but fail during runtime.

Step 4: Handle translation apps and custom pages separately. If you are using a third-party translation app alongside Shopify Markets, check whether the app is generating its own hreflang tags. If it is, you will need to disable one of the two sources to avoid duplication. Most reputable translation apps have settings that allow you to disable their hreflang output when the store is already using Shopify Markets. For custom pages and blog posts that are not covered by the automatic Shopify Markets injection, you will need to add hreflang tags manually through the page template or through a custom Liquid snippet that generates the correct tag set based on the page's locale and its equivalent URLs. This requires a developer-led approach to ensure that your custom logic respects the hierarchy of the Shopify Markets structure while providing the necessary coverage for the unique, non-standard templates that the native platform fails to automatically index with appropriate metadata.

Step 5: Validate the full implementation before indexing new markets. Before submitting a new market's pages to Google Search Console for indexing, run a full validation pass. Use Google's Rich Results Test or fetch the page directly in Google Search Console to confirm the hreflang tags are appearing in the rendered output, not just in the source HTML. Check that all bidirectional references are intact. Confirm the x-default tag is present and pointing to the correct URL. Verify that canonical tags on regional pages are self-referencing and not pointing to the primary English version. Once the validation is clean, submit the sitemap for the new market in Google Search Console and request indexing for priority pages. Following this rigorous sequence of post-deployment validation ensures that your initial indexing push is clean, preventing the long-term indexing bloat that occurs when Google starts crawling and caching improperly tagged, "incorrect" variants that you then have to manually clean up within the Search Console environment.

Common Mistakes in Shopify Hreflang Setup

The following mistakes appear repeatedly in international Shopify stores that are underperforming in their target markets. Most of them are not visible to the operators running the stores because they require crawling and tag-level inspection to identify. By proactively avoiding these pitfalls, you can bypass the common architectural failures that plague most international expansion attempts, ensuring that your technical foundation remains robust throughout your period of scaling. These errors are not merely inconveniences; they are structural faults that, left unaddressed, will cause your search performance to plateau or decline even as you add high-quality content to your international storefronts.

  • Conflicting Source Tags: Using a third-party translation app and Shopify Markets simultaneously without disabling hreflang output from one source, resulting in conflicting or duplicate tag sets on the same page.

  • Redirecting Targets: Setting hreflang tags to point to URLs that redirect to a different URL, which invalidates the tag and forces Google to make its own decision about which version to rank.

  • Omitted Fallback: Failing to include the x-default tag, leaving Google without a clear fallback instruction for users who do not match any specific locale target.

  • Ambiguous Language Codes: Using language-only codes such as en or fr when the store targets different regions within the same language, such as English for India and English for the UK, which prevents Google from differentiating between the two.

  • Noindex Conflicts: Adding hreflang tags to pages that have noindex directives, which creates a contradiction — Google cannot index a page and simultaneously use it as a hreflang reference.

  • Disconnected Signaling: Implementing hreflang through a sitemap but not in the page head, then using a theme that generates conflicting or absent hreflang in the HTML, creating inconsistency between the two signal sources.

  • Broken References: Not updating hreflang references after deleting or redirecting regional pages, leaving broken references that degrade the entire tag cluster.

Hreflang via HTML vs Sitemap — Which Approach Works Better for Shopify

Hreflang can be implemented in three ways: in the HTML head of each page, in the XML sitemap, or via HTTP headers for non-HTML files. For Shopify stores, the relevant choice is between HTML injection and sitemap implementation. Each has trade-offs that matter depending on the size and architecture of the store. Choosing the correct approach depends heavily on your store's engineering resources and whether you intend to maintain a standard Shopify theme or move toward a more complex, headless architecture. While HTML injection is the standard recommendation for the vast majority of merchants, the sitemap route offers a cleaner, more scalable path for enterprises managing massive, custom-built product catalogs where page-level head injection is technically difficult to maintain at scale.

Approach

How It Works

Best For

Key Limitation

HTML Head Injection

Tags added directly to the page head via theme.liquid

Stores under 10,000 pages, Shopify Markets native setup

Requires theme access; may conflict with translation apps

XML Sitemap Implementation

Hreflang added to each URL entry in the sitemap

Large catalogues, headless Shopify, custom build environments

Shopify's native sitemap does not support hreflang natively; requires a custom sitemap solution

Third-Party App

App generates and manages hreflang logic

Non-technical operators, stores using translation apps

App quality varies significantly; risk of conflicts with Shopify Markets


FAQs

What is hreflang and why do Shopify stores need it?

Hreflang is an HTML attribute that signals to search engines which language or regional version of a page should be shown to users in specific locales. Shopify stores that sell to multiple countries or offer content in multiple languages need it because without it, Google cannot reliably determine which version of a page to surface for a given audience. The result is often cross-market cannibalisation, where the wrong version ranks in the wrong country, reducing conversion rates and splitting search equity across duplicate pages. For any Shopify store operating in more than one language or country, hreflang is not optional — it is foundational infrastructure for international search performance. By implementing this correctly, you ensure that every market is treated as a distinct, optimized opportunity, preventing the "rank-stealing" behavior that occurs when your US storefront inadvertently attempts to compete with your Australian or UK-specific pages in the local search results of those countries.

Does Shopify Markets automatically add hreflang tags?

Shopify Markets does generate hreflang tags automatically for standard storefront pages when the store is correctly configured with multiple markets and distinct locale settings. However, the automatic implementation has coverage gaps. Custom pages, blog posts, app-driven content, and heavily modified themes do not always receive correctly formed hreflang tags through the native system. Stores that use third-party translation apps alongside Shopify Markets are at risk of receiving conflicting tag sets from two sources simultaneously. Automatic does not mean complete, and every international store should audit the actual tag output rather than assuming the platform has handled it fully. Relying on "native" functionality without verification is a common oversight that often leaves critical pages, such as deep-link marketing landing pages or unique local blog content, completely ignored by the hreflang signaling layer, which can result in these pages being indexed without any locale-specific association.

What happens if hreflang tags are missing or incorrect on a Shopify store?

When hreflang tags are missing, Google must infer which page version to rank for each market based on other signals such as domain, language of content, and user location. This inference is often incorrect, especially for stores targeting multiple English-speaking markets or offering content in closely related languages. Incorrect hreflang tags — such as non-reciprocal references, broken URLs, or mismatched canonical tags — are treated as errors by Google, which may choose to ignore the entire tag set and make its own ranking decisions. The practical consequence is that regional pages rank in the wrong markets, organic traffic is wasted, and conversion rates suffer because users land on pages in the wrong language or with the wrong currency and pricing. This creates a friction-heavy customer experience that directly erodes trust, as potential buyers may immediately bounce when they realize they are viewing a storefront configured for a different market than the one they are physically in.

Can I use hreflang with a third-party translation app on Shopify?

Yes, but you need to be deliberate about which system generates the hreflang output. If you are using Shopify Markets alongside an app like Weglot or Langify, both systems may attempt to generate hreflang tags independently, which results in conflicting or duplicate tag sets in the page head. Most translation apps have a setting to disable their own hreflang output when the store is using Shopify Markets. Check your app's documentation and confirm that only one system is producing the tags. After making changes, always verify the rendered HTML output on live pages to confirm the final tag set is clean and correct. Achieving this single-source-of-truth configuration is crucial, because Google's crawlers do not have a preference for which system provides the data, provided that the signals provided are consistent, accurate, and reciprocal across all identified language and region variants.

What is the x-default hreflang tag and is it required on Shopify?

The x-default tag designates the fallback page that Google should show to users who do not match any of the specific language or region targets defined in the hreflang set. For a Shopify store with markets in India, the UK, and Germany, the x-default would typically point to the primary English storefront — the page that serves as the universal fallback. It is not technically mandatory, but omitting it is a significant gap in most implementations. Without x-default, Google has no clear instruction for what to show users in countries or languages not covered by the other hreflang tags, which often results in inconsistent ranking behaviour in unspecified markets. This essentially acts as a "catch-all" signal that prevents the search engine from guessing, ensuring your core brand site remains the visible destination for global traffic that isn't specifically mapped to a sub-market you've already launched and configured.

How do I check if my Shopify hreflang tags are working correctly?

The most reliable method is to crawl your live store using Screaming Frog with hreflang extraction enabled, then audit the report for missing tags, non-reciprocal references, broken URLs, and canonical conflicts. You can also inspect the page source of individual pages in each language or region variant and manually confirm the hreflang tags in the head section. Google Search Console's International Targeting report surfaces some hreflang errors but does not always catch all configuration issues. For stores that have recently launched new markets or migrated between internationalisation systems, a full technical audit of the hreflang implementation is the only reliable way to confirm the setup is correct. By systematically reviewing these signals, you are essentially stress-testing your international architecture to ensure that every possible user intent is mapped to the most relevant landing experience, thereby solidifying your brand's authority across multiple disparate global search landscapes.

get in touch

Ready to Grow From Day One?

Strategy, execution, and digital experiences designed to move together. Fill out the form below and our team will contact you shortly.

get in touch

Ready to Grow From Day One?

Strategy, execution, and digital experiences designed to move together. Fill out the form below and our team will contact you shortly.

get in touch

Ready to Grow From Day One?

Strategy, execution, and digital experiences designed to move together. Fill out the form below and our team will contact you shortly.

© 2026 projectsupply AI, Data and Digital Engineering 

Company. Pune, India. All rights reserved.

Part of Tangle

© 2026 projectsupply AI, Data and Digital Engineering 

Company. Pune, India. All rights reserved.

Part of Tangle

© 2026 projectsupply AI, Data and Digital Engineering 

Company. Pune, India. All rights reserved.

Part of Tangle