Hreflang

Hreflang is an HTML attribute that tells search engines which language and region a page targets, so they serve the right version to each user.
SEO & GEO
Created on
02.08.2026

Summarize this

What hreflang is

Hreflang is an HTML attribute that tells search engines which language and geographic audience a page is meant for. When a website exists in several languages or regional variants, hreflang links those versions together and signals, for each one, the language (and optionally the country) it targets. Its job is simple but important: make sure a French speaker searching in France lands on the French page, while an English speaker in the United States gets the English one, instead of both being shown the wrong version.

The attribute takes the form hreflang="en-us" or hreflang="fr", where the first part is a language code and the optional second part is a country code. Search engines like Google use it as a strong hint when deciding which URL to display in results for a given user. Hreflang does not change rankings directly; it improves the match between a searcher and the correct localised page, which improves the experience and protects your international SEO.

Why hreflang matters

Without hreflang, a multilingual or multi-regional site sends confusing signals to search engines. Two big problems tend to appear. First, users can be served the wrong language, which pushes them to bounce. Second, near-identical pages (for example a UK and a US version of the same English content) can look like duplicate content, so the engine may pick one and ignore the others. Hreflang resolves both: it clarifies that these pages are alternates for different audiences, not duplicates competing with each other.

For any business selling across borders or languages, this is the difference between capturing a market and leaking it. Correct hreflang keeps each localised page eligible for its own audience and consolidates the authority of the page group instead of splitting it.

How to implement hreflang

There are three accepted ways to declare hreflang, and you pick one per site. The most common is adding <link rel="alternate" hreflang="..."> tags in the <head> of each page, one line per language version. Alternatively you can send the same information in the HTTP headers (useful for non-HTML files like PDFs) or list all alternates inside your XML sitemap. Whichever method you choose, the rules are the same.

  • Every version references every other version, including itself. The set of links must be complete and reciprocal.
  • Links must be bidirectional: if page A points to page B, page B must point back to A, or search engines ignore the annotation.
  • Use valid codes: ISO 639-1 for language and ISO 3166-1 Alpha 2 for country, for example en, fr, en-gb, es-mx.
  • Add an x-default: the value x-default marks the fallback page for users whose language or region you do not explicitly target.

Common mistakes

Hreflang is powerful but unforgiving of small errors, and most problems come from a handful of recurring mistakes. Missing return links are the classic one: an annotation only counts if it is reciprocated, so a one-way reference is simply dropped. Wrong or invented codes (like using en-uk instead of the correct en-gb, or a language code where a country code belongs) invalidate the tag. Pointing hreflang URLs at redirected or noindexed pages sends mixed signals, and mixing hreflang with careless canonical tags, for instance canonicalising every language version to the English one, can cancel the whole setup. Because these tags are easy to get subtly wrong across dozens of pages, auditing them with a dedicated tool or Search Console's reports is strongly recommended.

Hreflang and canonical tags together

Hreflang and canonical tags often confuse people because both deal with which URL matters, but they answer different questions. A canonical tag says "this is the master version of this exact page", used to consolidate duplicates. Hreflang says "these are equivalent pages for different languages or regions". The key rule is that each localised page should canonicalise to itself, not to another language, and then declare its hreflang alternates. Get that pairing right and search engines understand both that each page is authoritative for its own market and that the group forms one connected international set.

Hreflang at BeBranded

At BeBranded, multilingual sites are a core part of what we build, especially on Webflow, where native localisation and hreflang management make international projects far cleaner than they used to be. We set up hreflang so each language version is correctly linked and reciprocal, add an x-default for global visitors, and make sure canonical and hreflang work together rather than against each other. The payoff is concrete: users reach the right language on the first click, duplicate-content risk drops, and the SEO value of a page is shared across its versions instead of being diluted. For any brand serving more than one language or country, clean hreflang is one of the highest-leverage technical SEO details to get right.

FAQ

Hreflang tells search engines which language and region a page targets, so they can show the right version to each user. It links alternate language or country versions of a page together and prevents them from being treated as duplicate content.
You can add hreflang in three places: as link tags in the HTML head of each page, in the HTTP response headers, or inside your XML sitemap. Pick one method and apply it consistently across the whole site.
Yes. Hreflang annotations must be bidirectional: if page A points to page B as an alternate, page B must point back to A. If the return link is missing, search engines ignore the annotation entirely.
The value x-default marks the fallback page for users whose language or region you do not explicitly target. It is typically your default or international page and helps search engines choose a sensible option when no specific match applies.
Not directly. Hreflang does not boost your position; it improves which localised URL is served to a given user. That better match reduces bounces and duplicate-content confusion, which protects and supports your international SEO indirectly.
A canonical tag names the master version of one specific page to consolidate duplicates. Hreflang links equivalent pages across languages or regions. Each localised page should canonicalise to itself and then declare its hreflang alternates.

Ready to boost your conversions?

Our team is here to understand your needs & work with you to create your next projects.
Get news, infos and resources.
Actionable tips delivered straight to your inbox.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.