hreflang Tags Tester
Check hreflang annotations in HTML, HTTP headers or XML sitemaps: language and region codes, return links, self-references and x-default. How it Works
Codes
Language and region codes, duplicates, self-references and x-default.
Return Links
Every alternate fetched: it must answer 200, be canonical, indexable and link back with the same code.
The Cluster
Who lists whom across the set, for one page, up to 10 pages, or whole XML sitemaps.
A Real Example
Checked 17 November 2026https://www.atlassian.com/
- What the tool found
- The home page lists 11 language versions (ja, fr, de, es, pt-BR, zh-Hans and five more) but not itself, and has no x-default. All 11 report No return link: each version lists itself and the other ten, never the English home page, so the English page is outside its own cluster.
- What to do
- Add the English home page to every version's set, including its own, as hreflang en pointing at https://www.atlassian.com/, and add an x-default.
Reading the Result
Missing Return Link
Page A lists page B, but B doesn't list A. Google ignores annotations that aren't confirmed both ways.
Invalid Code
The language must be ISO 639-1 and the optional region an ISO 3166-1 alpha-2 country: en-GB, not en-UK.
Canonicalised Elsewhere
Annotations on a page that points its canonical at another URL are ignored. List canonical URLs only.
No Self-Reference or x-default
Each version should also list itself. x-default is optional: the page for visitors who match none of the others.
What it Can't Tell You
- hreflang is a hint: Google can still show another version when it judges it a better match.
- A single page is checked against the pages it points to. For a whole site, test its sitemaps.