Skip to content

International SEO

Shopify Hreflang Errors: How to Spot and Fix Them

By Shayan Ahmad · · 6 min read

Shopify Hreflang Errors: How to Spot and Fix Them (WhiteLinko blog banner)

Hreflang is the code that tells Google which version of a page to show shoppers in each country and language. When it works, a shopper in Canada sees your Canadian page, priced in Canadian dollars, and a shopper in the UK sees your UK page. When it breaks, Google may show the wrong version, or ignore some versions entirely.

Shopify Markets adds hreflang automatically, which removes most of the work. But errors still creep in, usually because other settings, apps or customisations interfere. This guide explains the common hreflang mistakes on multi-country Shopify stores and how to check for them.

How Hreflang Works on Shopify

When you set up Markets with their own URLs, such as subfolders like /en-ca/ and /en-gb/, Shopify adds hreflang tags to the head of each page. Each tag lists one version of the page and the language and country it is for. Every version of a page should list:

  • Every other version of the same page.
  • Itself.
  • Usually an "x-default" version, the fallback for shoppers who do not match any listed market.

Shopify's automatic tags generally follow these rules. Most hreflang problems on Shopify stores come from what surrounds them.

Error 1: Duplicate Hreflang From Apps

Translation and currency apps sometimes add their own hreflang tags. If Shopify's tags and an app's tags both appear on the page, they may conflict, listing different URLs for the same market.

How to spot it: view the source of a page and search for "hreflang". Count the tags. If the same language and country code appears twice, or you see URLs in different formats, something is duplicating them.

How to fix it: pick one source, usually Shopify's built-in Markets output, and disable the app's hreflang setting or remove its code.

Error 2: Wrong Language or Country Codes

Hreflang uses specific codes: a language code, optionally followed by a country code. Common mistakes include using "uk" for the United Kingdom, when the correct country code is "gb", or using a country code alone without a language. Shopify's automatic output uses correct codes, but custom or app-generated tags sometimes do not.

How to spot it: check each code against the standard language and country code lists.

Error 3: Missing Return Links

Hreflang works in pairs. If your UK page says "the Canadian version is here", the Canadian page must also say "the UK version is here". If one side is missing, Google may ignore the relationship.

This often happens when a page exists in one market but not another, or when content was added to one market manually.

How to spot it: check the same page in two markets and make sure each lists the other.

Error 4: Hreflang Pointing to Redirected or Missing Pages

Every URL in a hreflang tag should load directly, with a normal 200 status. If a tag points to a page that redirects or returns a 404, the relationship breaks.

A common cause is products unavailable in certain markets. If a product is excluded from a market but the hreflang still lists that market's version, shoppers and Google are sent to a page that does not work properly.

How to spot it: click through each URL in the hreflang tags for a few important pages and check that each one loads as expected.

Error 5: Canonicals That Contradict Hreflang

Each market version should have a canonical tag pointing to itself. If your Canadian page's canonical points to the main US page, you are telling Google to ignore the Canadian page, while the hreflang says to show it. Google usually follows the canonical, and your local version disappears from local results.

How to spot it: on a market page, check the canonical includes the market subfolder or domain.

Error 6: Automatic Redirects by Location

Forcing visitors to their local version based on location can stop Google from seeing your other versions, because Google's crawler mostly visits from the United States. Hreflang only helps if Google can actually reach every version.

How to fix it: use a banner or pop-up suggesting the local version instead of a forced redirect.

Error 7: Untranslated or Near-Identical Content

Hreflang tells Google pages are alternatives for different audiences. If your French Canadian version is mostly English, or your English versions for different countries are identical down to the currency, Google may treat them as duplicates and show just one.

How to fix it: translate content properly, including search titles and meta descriptions, and add genuine local differences, such as currency, spelling, delivery details and locally relevant products.

Error 8: Custom Code Left Over From Old Setups

Stores that sold internationally before Markets often have old hreflang code hard-coded into the theme, or old apps that handled it. After moving to Markets, that old code can sit alongside Shopify's automatic tags.

How to spot it: search your theme code for "hreflang". If you find manual tags in theme.liquid or snippets, check whether they duplicate what Shopify now outputs.

How to Check Hreflang

Google Search Console used to have a dedicated international targeting report showing hreflang errors, but that report has been retired. Today, checking hreflang takes a few approaches together:

  1. View the page source on a sample of key pages in each market and read the tags.
  2. Use a crawling tool that reports hreflang, which can check every page for missing return links, wrong codes and broken URLs.
  3. Use Search Console's Performance report. Filter by country and by page to see whether shoppers in each country are landing on the right version. If Canadian searchers mostly land on your US pages, something is wrong.
  4. Use URL Inspection on market pages to confirm they are indexed and that Google accepts your declared canonical.
  5. Search from each country, using a VPN or by asking someone there, to see which version appears.

Which Errors to Fix First

If your checks turn up several problems, fix them in order of impact. Canonicals that point every market to the main version come first, because they can remove whole country versions from search. Forced location redirects come next, because they stop Google reaching your local pages at all. Duplicate or conflicting tags from apps and old code follow. Translation quality and small code mistakes matter, but they rarely cause the dramatic losses the first three can.

Prevention Is Easier Than Repair

Most hreflang errors are avoidable with a few habits: let Shopify Markets handle hreflang rather than apps, avoid forced location redirects, translate content properly, and check a sample of pages after any change to markets, apps or the theme. This is the kind of setup our international SEO service handles, from structure to local content.

FAQs

Does Shopify handle hreflang automatically?

Yes, when markets have their own URLs. Errors usually come from apps, old code, canonicals or redirects interfering.

Where can I see hreflang errors in Search Console?

The dedicated report has been retired. Use page source checks, crawling tools and the Performance report filtered by country instead.

What is x-default?

It tells Google which version to show shoppers who do not match any specific language or country you have listed. Many stores point it to their main international version.

Do I need hreflang if I only sell in one country?

No. Hreflang only matters when you have multiple versions of pages for different languages or countries. Our guide to SEO for businesses in several cities covers regional targeting within one country, and our SEO glossary explains the terms used here.

Selling in Several Countries?

If you suspect shoppers are seeing the wrong version of your store, our Shopify SEO team can check every market. Start with a free SEO audit and we will tell you whether your country versions are working as intended.

  • hreflang
  • shopify markets
  • international seo
  • canonical tags
  • multi-country stores

Have a question about this for your own site?

A 15-minute call is usually enough to tell whether it applies to you and what to do first.

Book a 15-min callGet My Free SEO Audit

Related posts

All blog posts →

Talk to WhiteLinko

Want this applied to your site?

Book a 15-minute call to talk through your goals, or start with a free SEO audit: a prioritised list of fixes, reviewed by a specialist.

Free PDF · 2026 edition

The WhiteLinko SEO Checklist

Six pages of tick boxes: technical, on-page, content, local, links, AI search and GA4.

Get the checklist
Free SEO Audit