Introduction
Hreflang tags help search engines understand which language or regional version of a webpage is intended for different audiences. For example, if a website has separate English and Spanish pages, hreflang annotations can help Google understand the relationship between those versions and show the appropriate URL to users.
For multilingual websites, implementing hreflang correctly means using valid language and regional codes, referencing the correct URLs, and ensuring the annotations are consistent across alternate pages. This guide explains how hreflang tags work, how to implement them, and which common mistakes to avoid.
What Are Hreflang Tags in SEO?
Hreflang is an attribute used to identify alternate language or regional versions of a webpage. You can implement it through HTML link elements, HTTP headers, or XML sitemaps, depending on your website’s setup.
For example, a website might have an English page at example.com/ and a Spanish version at example.com/es/. Hreflang annotations can identify these as alternate versions of the same content.
Hreflang does not automatically translate a page, guarantee indexing, or directly improve rankings. Its purpose is to help search engines understand the intended audience and relationship between localized URLs.
How Hreflang Tags Help Multilingual Websites
Hreflang tags help search engines understand the relationship between pages designed for different languages or regions. For example, a business serving customers in the United States and the United Kingdom might have separate English-language pages with different pricing, spelling, or product availability. Hreflang annotations can help Google understand which version is intended for each audience.
They are especially useful when a website has:
- Multiple language versions: Such as English and Spanish pages targeting different language audiences.
- Regional versions of the same language: Such as English pages for the United States and the United Kingdom.
- Localized product or service pages: Where information, availability, or offers vary by market.
Hreflang is a signal, not a guarantee. Google considers several factors when selecting which URL to show in search results, so correct implementation does not guarantee that a particular page will appear for every user.
It is also important to distinguish hreflang from canonical tags. Hreflang identifies alternate language or regional versions, while canonical tags help indicate the preferred URL among duplicate or very similar pages. They serve different purposes and should be configured carefully.
For a practical example of multi-region SEO work, explore our Ressichem case study, which covers regional SEO signals, hreflang, and technical SEO improvements.
How to Implement Hreflang Tags
Hreflang can be implemented in three main ways: HTML link elements, HTTP headers, or XML sitemaps. Choose the method that fits your website’s setup, and make sure the annotations consistently identify all relevant language or regional versions of each page.
1. HTML Link Tags
For standard web pages, hreflang annotations are commonly placed in the <head> section of the HTML document. Each localized version should list itself and its alternate versions using their full URLs.
For example, an English page and its Spanish equivalent could use these annotations:
<link rel=”alternate” hreflang=”en”
href=”https://example.com/” />
<link rel=”alternate” hreflang=”es”
href=”https://example.com/es/” />
Both pages should contain the corresponding set of alternate references, including a reference to themselves. Use valid language codes and, when needed, region codes such as en-gb or es-mx.
2. HTTP Headers
HTTP headers are useful when you need to specify alternate language versions for files that do not contain HTML, such as PDFs. Instead of adding a <link> element to a page’s HTML, the server sends hreflang information in its HTTP response headers.
For example, a PDF available in English and Spanish could use a header like this:
The header should list the relevant alternate versions, including the version represented by the response. Keep the URLs accurate and ensure the alternate pages reference one another consistently.
3. XML Sitemap Implementation
If your website manages many localized URLs, an XML sitemap can be a practical way to maintain hreflang annotations. Each URL entry lists its alternate language or regional versions using the xhtml:link element.
The following is a simplified XML sitemap snippet showing how hreflang annotations are added to a URL entry. A complete implementation must also declare the required XML and XHTML namespaces and include a separate URL entry for each localized version.
The sitemap must declare the XHTML namespace, and each localized URL entry should list all relevant variants, including itself. The same set of alternate URLs should be represented consistently for each version.
You don’t need to implement hreflang through all three methods. Google treats HTML, HTTP headers, and XML sitemaps as equivalent approaches, so choose the method that is easiest to maintain correctly. Using multiple methods without a clear need can make inconsistencies harder to troubleshoot.
Hreflang Examples: Language and Regional Codes
Hreflang codes identify a page’s language and, optionally, its target region. This helps search engines distinguish versions such as US English and UK English.
For example, a website targeting English-speaking users in the United States and United Kingdom may have separate pages with different pricing, spelling, or product availability. Hreflang annotations help search engines understand which version is intended for each audience.
Common Hreflang Codes
Hreflang codes combine a language code with an optional regional code to identify the intended audience for each page. Here are some common values and what they mean:
Hreflang code | Meaning |
en | English |
es | Spanish |
en-gb | English for the United Kingdom |
en-us | English for the United States |
es-mx | Spanish for Mexico |
x-default | Fallback page for users whose language or region isn’t specifically matched |
Language and Regional Code Example
Suppose your website has separate English pages for the United States and the United Kingdom. You can use the following hreflang annotations:
<link rel=”alternate” hreflang=”en-US”
href=”https://example.com/us/” />
<link rel=”alternate” hreflang=”en-GB”
href=”https://example.com/uk/” />
Here, en-US identifies the US English version, while en-GB identifies the UK English version. Each page should also include a self-referencing hreflang annotation and reciprocal references to the other relevant versions.
You can also use x-default to identify a fallback page when no specific language or regional version matches a user’s preferences.
Important: Use valid language and regional codes. Language codes generally follow ISO 639-1, while regional codes follow ISO 3166-1 Alpha-2. Hreflang helps search engines interpret localized pages, but it does not guarantee that a particular URL will appear in search results for every user.
Common Hreflang Mistakes to Avoid
Incorrect hreflang implementation can make it harder for search engines to understand the relationship between localized pages. Check these common mistakes when setting up hreflang tags for a multilingual website.
1. Using Invalid Language or Regional Codes
Hreflang values must use valid language codes and, when applicable, valid regional codes. For example, use en-GB for English targeting the United Kingdom rather than an incorrectly formatted or invented code.
2. Missing Return Links
If an English page references a Spanish version, the Spanish page should also reference the English version. These reciprocal annotations help search engines confirm the relationship between alternate URLs.
3. Pointing to Incorrect URLs
Every hreflang URL should point to the correct, fully qualified page address. Avoid URLs that redirect to unrelated pages, return errors, or point to the wrong language version.
4. Forgetting the Self-Referencing Hreflang Tag
Each localized page should include a reference to itself as well as its relevant alternate versions. See the self-referencing hreflang section below for details.
5. Using Inconsistent Annotations
The alternate language and regional URLs should be consistent across all versions of the page. If one page lists a Spanish URL but the Spanish page does not reference the corresponding English version, the implementation may be incomplete.
6. Using Hreflang for Unrelated Pages
Hreflang should connect pages that are genuine language or regional alternatives to one another. Do not use it to link unrelated pages simply because they belong to the same website.
How to Avoid These Mistakes
Before publishing hreflang annotations, verify that every URL is correct, each page references itself and its relevant alternatives, and reciprocal links are present. You can also inspect your XML sitemap or HTML source to identify missing or inconsistent annotations.
Correct implementation helps search engines interpret localized pages, but it does not guarantee indexing or a particular ranking in search results.
Self-Referencing Hreflang: What You Need to Know
A self-referencing hreflang tag tells search engines which language or regional version the current page represents. It does this by including the page’s own URL in its hreflang annotations, alongside links to its alternate versions.
For example, if your website has an English homepage and a Spanish version, the English page should reference itself and the Spanish page:
<link rel=”alternate” hreflang=”en”
href=”https://example.com/” />
<link rel=”alternate” hreflang=”es”
href=”https://example.com/es/” />
The Spanish page should also include its own URL and reference the English version. This reciprocal setup helps search engines understand the relationship between the two pages.
Why Is Self-Referencing Hreflang Important?
Self-referencing annotations help maintain a complete hreflang setup by identifying the current page as one of the available language or regional versions. They should be included alongside reciprocal references to the other relevant URLs.
When checking your implementation, make sure that:
- Each localized page includes a hreflang reference to itself.
- Every alternate URL points to the correct language or regional page.
- All relevant alternate pages reference one another consistently.
- The URLs use the correct protocol and canonical destination.
Self-referencing hreflang is part of a consistent implementation, but it does not guarantee indexing or improved rankings by itself.
Hreflang on Shopify and Drupal
Implementing hreflang tags on Shopify or Drupal depends on your website’s structure, the number of language versions, and the tools or modules you use. The goal is the same on both platforms: ensure that each localized page references itself and its relevant alternate versions correctly.
Hreflang on Shopify
Shopify automatically generates hreflang tags for international markets when distinct domains, subdomains, or subfolders are configured for different language or regional versions. Before adding a third-party app or custom implementation, check your Markets, language, and domain settings and inspect the generated page source.
To check hreflang on Shopify:
- Inspect your storefront’s page source for hreflang annotations.
- Confirm that each annotation points to the correct localized URL.
- Check whether your theme or translation app already generates the tags before adding a separate implementation.
Avoid adding duplicate hreflang tags if your theme or app already generates them. If you use a third-party translation app, check its documentation to understand how it handles alternate URLs.
Hreflang on Drupal
Drupal websites can generate hreflang annotations through multilingual functionality and compatible modules, depending on the Drupal version and site configuration. Check which components generate the tags before adding another module, then verify the output on translated pages and other relevant URL types.
To check hreflang in Drupal:
- Confirm that the relevant language and content translations are configured.
- Inspect translated pages to verify the generated hreflang URLs.
- Review your SEO modules or custom templates for missing or duplicate annotations.
If your Drupal site uses custom templates or SEO modules, review their output before adding another implementation method.
Which Platform Checks Matter Most?
On either platform, test representative localized pages to confirm that URLs resolve correctly and alternate versions reference one another consistently. Check the generated output before applying changes across the entire website.
How to Check and Troubleshoot Hreflang Tags
After implementing hreflang tags, check that search engines can access the localized URLs and understand the relationships between them. Reviewing the HTML source, HTTP response headers, or XML sitemap can help you identify common implementation issues.
1. Inspect the Page Source
Open a localized webpage in your browser, right-click, and select View Page Source. Search for hreflang to find the alternate language annotations.
Check that each annotation uses a valid language or regional code and points to the correct URL. If your website uses JavaScript or an SEO plugin to generate tags, verify that the expected annotations appear in the rendered page output.
2. Check Reciprocal Links
Compare alternate annotations across localized pages and confirm that each page references the other relevant versions. Missing or mismatched return links should be corrected.
Make sure each page includes its own URL and all relevant alternate versions.
3. Verify URLs and Canonical Tags
Confirm that hreflang URLs point to the intended localized pages and return successful HTTP responses. Check for broken URLs, unexpected redirects, and incorrect canonical tags.
Each localized page should generally have a canonical URL that points to itself. Avoid canonicalizing all language versions to one language page unless there is a specific reason to treat them as duplicates.
4. Review Your XML Sitemap
If you use an XML sitemap for hreflang, check that it includes the correct localized URLs and the required xhtml:link annotations. The sitemap must also declare the appropriate XHTML namespace.
Make sure the alternate references are consistent across the localized URL entries.
5. Use Google Search Console
Use Google Search Console to inspect individual localized URLs, review indexing status, and identify accessibility or indexing issues. The URL Inspection tool can help you understand how Google sees a particular page, although it does not provide a complete hreflang validation report.
For additional checks, use a reputable hreflang validation tool to identify missing return links, invalid codes, or inconsistent alternate URLs.
Final Troubleshooting Checklist
Before considering your implementation complete, confirm that:
- Hreflang codes and alternate URLs are valid.
- Each localized page references itself and its relevant alternatives.
- Reciprocal annotations are consistent across language versions.
- Canonical tags and your chosen implementation method are configured correctly.
WordPress website mein hreflang tags kaise add karein?
The easiest way to add hreflang tags in WordPress is to use a multilingual plugin like WPML or Polylang. Once you add your languages and connect each page to its translation, the plugin adds the tags for you.
No plugin? You can add the tags manually in your child theme’s header file or through your XML sitemap. After that, view the page source and check that every page references itself and its alternate versions.
Get Your Multilingual SEO Setup Right
A well-structured multilingual website needs more than translated content. Correct hreflang annotations, consistent localized URLs, and appropriate canonical tags help search engines understand how your language and regional pages relate to one another.
Before publishing new language versions, review your hreflang implementation, check for missing return links, and verify that each annotation points to the correct page. Regular checks can help you identify inconsistencies as your website grows.
Need help improving your website’s international search visibility? Explore Expando’s SEO services or contact our team to discuss your website’s technical SEO requirements.
Frequently Asked Questions
1. What Are Hreflang Tags in SEO?
Hreflang tags are HTML attributes that tell search engines which language or regional version of a webpage is intended for a specific audience. They help Google understand the relationship between localized pages, such as US and UK English versions, so it can serve the appropriate URL to users. Hreflang can be implemented through HTML, HTTP headers, or XML sitemaps.
2. Does Hreflang Improve SEO Rankings?
Hreflang does not directly improve search rankings. Instead, it helps search engines understand which language or regional page is relevant to different audiences. Correct implementation can support international SEO by helping Google identify the appropriate localized URL, but it does not guarantee indexing, rankings, or that a specific version will appear in search results.
3. How Do I Add Hreflang Tags in HTML?
To add hreflang tags in HTML, place link rel=”alternate” elements inside the page’s <head> section. Each tag should use a valid language or regional code and the full URL of the corresponding localized page. Every language version should reference itself and its relevant alternate pages, with reciprocal links between versions to maintain a consistent implementation.
4. Is a Self-Referencing Hreflang Tag Necessary?
Yes, each localized page should include a self-referencing hreflang annotation alongside references to its relevant alternate versions. For example, an English page should identify its own URL as the English version and link to its Spanish equivalent. The alternate pages should also reference one another consistently, using correct URLs and valid language or regional codes.
5. What Is the Difference Between Hreflang and Canonical Tags?
Hreflang tags help search engines understand which language or regional version of a page is intended for a particular audience. Canonical tags indicate the preferred URL among duplicate or very similar pages. They serve different purposes: localized pages should generally have self-referencing canonical tags, while hreflang annotations connect the relevant alternate versions.
6. How Can I Check Whether My Hreflang Tags Are Working?
To check hreflang tags, inspect the page source and search for hreflang annotations. Verify that language codes and full URLs are correct, every localized page references itself, and alternate pages contain reciprocal links. Also review canonical tags, redirects, and XML sitemap entries if applicable. Google Search Console’s URL Inspection tool can help check indexing and accessibility, while a dedicated hreflang validator can identify implementation errors.
