Definition
The attribute appears on <link rel="alternate" hreflang="…" href="…"> elements in a page's head, in an
HTTP Link header, or in XML sitemap entries. Each value is an ISO 639-1 language code with an optional
ISO 3166-1 region code (en, en-GB, pt-BR), plus the reserved x-default for the version to show when
nothing matches. Google's documentation describes it as the way to tell Search about localised versions of
a page.
In practice
Every version of a page lists every version including itself; each version is its own canonical
(Canonical TagTells search engines the preferred URL.); the URLs are absolute and final; and one x-default names the fallback.
A one-directional annotation (A lists B, B does not list A) is reported as a missing return tag and may be
ignored, which is the most common failure on large sites. The hreflang guide
covers generating and validating the annotations at scale.
Two editions, one group
A company serves the same product page in English for the United Kingdom and in German. The UK page lists
itself as en-GB, the German page as de, and the UK page as x-default; the German page lists exactly
the same three entries. Both pages are self-canonical. A searcher in Germany is shown the German page;
a searcher whose settings match neither is shown the UK page.
What it does not do
It is not a ranking signal, it does not translate, it does not geotarget a site (URL structure does that), and it cannot rescue near-duplicate editions that differ only in currency from being folded together.
Common mistakes
- Missing return tags; missing self-reference; region codes without a language.
- Canonicalising every edition to the primary one.
- Pointing at redirecting, blocked or noindexed URLs.
- Hand-maintained annotations on a site with a release cadence.
