Free tool Hreflang checker: tags, codes and return links
Enter a page URL and the checker reads its hreflang annotations from the HTML and the HTTP Link header, validates every language and region code, and checks the self-reference, x-default and duplicates. Then it fetches each alternate version (up to eight) to confirm it links back, returns 200 and has a consistent canonical, because Google ignores hreflang pairs that do not point to each other.
- Codes checked against ISO lists
- Return links verified
- Via check.tapcub.com
Check a page’s hreflang set
Enter a URL and click Check. With “Check return links” on, each alternate page is fetched one after another, which uses up to 9 requests for one check.
check.tapcub.com, a TapCub service on Cloudflare Workers. It fetches the page from Cloudflare’s network (8-second timeout, up to 5 redirects, first 512 KB of the body), identifies itself with a From: tools@tapcub.com header, and returns the response to your browser, where all the analysis happens. With return links on, it then fetches each alternate URL listed on the page, one at a time and at most 8. It keeps no copy of the page; its logs hold the domain, status code and timing, not the full URL. Limit: 10 fetches a minute and 200 a day per IP address.In paste mode this is the address of the pasted page, used for the self-reference check.
The <head> is enough. Return links are not checked in paste mode.
Annotations
3
Including x-default
Errors
0
Tags Google will ignore
Warnings
0
Worth fixing
Alternates fetched
1
Link back
1
Alternates that list this page
Checks
Errors first. Line numbers refer to the page source.
- OKThe page lists itself (en).
- OKAn x-default fallback is present.
- OKAll 1 alternate page(s) checked link back to this page.
Annotations on this page
| hreflang | URL | Source | Status |
|---|---|---|---|
en | https://tapcub.com/tools/utm | HTML | This page |
zh-CN | https://tapcub.com/zh/tools/utm | HTML | OK |
x-default | https://tapcub.com/tools/utm | HTML | This page |
Return links
Each alternate page as fetched.
| hreflang | Alternate URL | HTTP | Links back? | Canonical |
|---|---|---|---|---|
zh-CN | https://tapcub.com/zh/tools/utm | 200 | Yes (en, x-default) | Self |
<link rel="alternate" hreflang="en" href="https://tapcub.com/tools/utm" />
<link rel="alternate" hreflang="zh-CN" href="https://tapcub.com/zh/tools/utm" />
<link rel="alternate" hreflang="x-default" href="https://tapcub.com/tools/utm" />Codes normalised, duplicates removed, x-default last. Put the same set on every version.
Share these inputs: the values go after the # in the link, so they never reach a server.
https://tapcub.com/tools/hreflang-checker
Version v1.0Updated Update history
What makes an hreflang set work
Google uses an hreflang pair only when both pages agree. Most problems are one side of a pair missing or pointing somewhere slightly different.
Return links
If page A lists page B, page B must list page A. Without that, Google ignores the pair. The return links table shows each alternate as it was fetched and whether it mentions this page.
Self-reference
Each version lists itself as well as all the others, so the set is identical on every page. A set that omits the current page is a common template bug.
Exact URLs
The URLs must be the final, canonical addresses: https, with or without www and the trailing slash exactly as served. An annotation that points to a redirect or a non-canonical URL weakens the cluster.
Valid codes
A two-letter ISO 639-1 language, optionally a script (zh-Hant) and an ISO 3166-1 region (en-GB). Region alone, en-UK or es-419 do not work.
The checker looks at one page and its direct alternates. It does not crawl the whole cluster, read XML sitemap annotations or run JavaScript. If your hreflang lives in the sitemap, check it with the sitemap tools instead.
Check one language cluster
Start from any version; the checker follows the links from there.
-
1
Enter one version’s URL
Use the exact address that should rank in that language.
-
2
Leave “Check return links” on
The checker fetches each alternate (up to 8) one by one. Turn it off if you only want to validate the tags on this page.
-
3
Read errors first
Missing return links, missing self-reference and invalid codes are what make Google ignore the annotations.
-
4
Copy the suggested set
It lists every version once with normalised codes. Put the identical set on every page in the cluster, then check another version.
What is checked, and against what
All rules come from Google’s guide “Tell Google about localized versions of your page”, plus its canonicalization guide for the canonical checks.
- Sources read:
<link rel="alternate" hreflang="…" href="…">in the<head>, and the HTTPLinkheader withrel="alternate"; hreflang="…" - Codes: ISO 639-1 language, optional ISO 15924 script, optional ISO 3166-1 alpha-2 region, or
x-default; same validator as the hreflang generator - URLs must be absolute with http or https; the page itself must appear in its own set; each code may point to one URL only
- Return link: an alternate counts as linking back when any of its annotations resolves to exactly this page’s URL
| Finding | Effect | Fix |
|---|---|---|
| Alternate does not link back | Google ignores that pair | Add the same full set to the alternate |
| Page does not list itself | Set is incomplete | Include a self-referencing link |
en-UK, es-419 | Code is ignored | Use en-GB; list specific countries |
href="/de/" | Relative URL | Write https://example.com/de/ |
| Alternate redirects | Signals split between two URLs | Point to the final URL |
The sample: an English page with a Chinese version
The default result is https://tapcub.com/tools/utm and its Chinese alternate, both fetched on 2026-11-17.
| hreflang | URL | Result |
|---|---|---|
| en | https://tapcub.com/tools/utm | This page, self-reference present |
| zh-CN | https://tapcub.com/zh/tools/utm | 200, links back as en and x-default, canonical to itself |
| x-default | https://tapcub.com/tools/utm | Fallback set to the English page |
Three annotations, no errors. The Chinese page carries the same set, so both directions of the pair are confirmed.
Why hreflang gets ignored
The tags are short; the mistakes are in how the set is maintained across pages.
One-way annotations
The English page lists the German one, but the German template was never updated. Google drops the pair.
URLs that redirect
http, missing trailing slash or an old path that 301s. Each alternate should be the exact final URL.
Country codes as languages
jp for Japanese, cn for Chinese, en-UK for Britain. The checker shows the correct code.
Mixing with noindex or foreign canonicals
An alternate that is noindex or canonicalises to another language cannot represent its language in results.
See whether each language version gets its audience
Correct hreflang sends people to the right version. TapCub shows visits by country, language and page so you can tell whether it works.
Hreflang checker questions
Still have a question?
Chat with the team behind TapCub — we usually reply within a few hours on business days.
How do I check hreflang tags on a page?
Enter the URL above and click Check. The tool reads every hreflang annotation in the page’s head and HTTP Link header, validates the codes and URLs, and then fetches each alternate page to see whether it links back.
What are hreflang return links?
If page A says page B is its German version, page B must also list page A. Google’s documentation says that if two pages do not both point to each other, the tags are ignored. Missing return links are the most common hreflang error.
Does every page need to reference itself?
Yes. Google asks for each version to list itself as well as every other version, so the set is the same on all pages in the cluster.
Is x-default required?
No. It is a fallback for users whose language does not match any listed version, useful for a language selector or an automatically redirecting home page. The checker notes when it is missing but does not count it as an error.
Why only 8 alternates?
Each alternate is a separate fetch, and the service allows 10 fetches a minute per visitor. Eight alternates plus the page itself fits in one minute. For larger clusters, check the most important versions, or check from another version to cover the rest.
Can it check hreflang in my XML sitemap?
Not this tool. It reads annotations from the page HTML and HTTP headers only. Generate sitemap annotations with the hreflang generator.
Whose rules does the checker follow?
Google’s, from its guide on localized versions. Other search engines may treat hreflang differently; Baidu, for example, publishes no hreflang documentation. A set that passes here is the format Google documents.
Update history
New features, fixes and data refreshes for this tool, newest first.
-
· v1.0
LaunchedFirst release.
Data this tool relies on
- Sample page fetched from tapcub.com — checked 2026-11-17, reviewed every 3 months (next review by 2027-02-17)
Missing something or found an error? Tell us — requests that come up often go into the next update. All tool updates
Fix the set, then check the pages
Generate a clean set, then make sure every version is indexable.