Free Hreflang Checker with Exact Return-Link Fixes
Paste head tags, sitemap XML or CSV rows. Get the exact pair that is broken, the exact line to add and copy-ready markup for all three hreflang methods.
How to Validate Hreflang Return Links in Minutes
Hreflang fails quietly. Google does not email you when a return link is missing, it just shows the wrong language to the wrong country. This free hreflang checker turns the silent failure into a list you can fix in one sitting:
- Paste the markup. Head tags, a sitemap with xhtml:link entries or CSV rows from a crawler export. The tool detects the format and says which one it found.
- Read the exact pairs. Errors never say the cluster is broken. They say which page is missing which return tag and show the exact link tag to add, with a copy button.
- Run the code coach. Invalid codes come back with the corrected value: en_US to en-US, en-UK to en-GB, eng to en. The coverage matrix shows every page against every code in the set.
- Ship the corrected markup. Switch between head tags, sitemap XML and HTTP Link header output. Copy the block or download the issues CSV for your developer.
Turn on strict mode when you paste the whole cluster at once. Then any target that points outside the paste counts as an error instead of an unknown, which catches half migrated locale rollouts.
What the Hreflang Validator Checks
Most free hreflang checkers stop at parsing. This one validates and then generates the fix:
- Reciprocal return links. Every pair is checked in both directions, and the fix line uses the correct code: the return tag carries the language of the page it points back to, not the language of the page receiving the tag.
- Self references. Each page must declare itself. When the self tag exists but carries a bad code, the validator still runs the rest of the cluster using the coach suggestion so one pass finds every error.
- ISO code coach. Language and region codes are validated against ISO 639-1 and ISO 3166-1 with a suggestion for every failure, including the wrong region codes that slip past pattern checks like en-UK and en-EU.
- Canonical conflicts. When a pasted head block includes a canonical pointing elsewhere, you get a warning that the whole hreflang set will be ignored, matching what Google does in practice.
- Cluster health. Pages are grouped into sets with a score from 0 to 100, a pass or fail banner and a coverage matrix of pages by language codes.
- Three output methods. Corrected head tags, a corrected sitemap block with the xmlns namespace and one Link header line per response. Hreflang on PDFs and non HTML assets only works through the header method, and this tool generates it.
Pair this with the Canonical Tag Checker when a locale page canonicalizes elsewhere, or run the free SEO audit tool for a full crawl across all your locale directories. For international sites with migration risk, our SEO audit services cover hreflang strategy end to end.
Related Free SEO Tools by Clienvora
- Canonical Tag Checker - Find canonicals that cancel your hreflang set.
- Redirect Chain Checker - Confirm locale URLs redirect in one hop.
- Robots.txt Checker - Make sure no locale directory is blocked.
- SERP Preview - Check titles and descriptions per market.
Frequently Asked Questions
What is hreflang and why do return links matter?
Hreflang tells Google which language and region version of a page to show in each country. It only works as a two way agreement. If your English page points at the French page, the French page must point back at the English page. Missing return links are the most common hreflang failure and the hardest error to spot by eye.
How do I check my hreflang tags with this tool?
Paste your markup into the box and the validator detects the format on its own. Head tags work when each block starts with its page URL on its own line. Sitemap XML works with xhtml:link entries. CSV rows work as page_url, hreflang, alternate_url. Every error shows the exact pair that is broken and the line to add.
How do I validate hreflang in a sitemap?
Paste the sitemap XML directly. The tool reads every url block, collects the xhtml:link alternates, rebuilds each cluster and checks reciprocity exactly the same way it checks head tags. Online validators that only read head markup cannot do this, and sitemap embedded hreflang is the method most large sites use.
Which hreflang codes are valid?
Use an ISO 639-1 two letter language, optionally plus an ISO 3166-1 region in uppercase, such as en-US, fr-FR, de-DE or pt-BR. The built in coach fixes the common mistakes: en_US becomes en-US, en-UK becomes en-GB, eng becomes en and en-EU loses the region. Every invalid code shows the corrected value.
Does x-default have to be included?
No. Google treats x-default as optional, so the tool prints it as a note instead of an error. When you do use it, point it at your default language version or the page you show to unmatched locales. Strict mode only tightens unknown target checks, never x-default.
Is my hreflang markup uploaded?
No. Parsing, validation and fix generation run in your browser. Sitemap files from large international sites often contain unreleased URLs, so nothing is sent to a server and nothing is stored after you close the tab.