TapCub is live — analytics, insights and live chat, free on one platform

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.

Checker
What is sent, and to whom. Nothing is requested when this page opens: the result below is a dated sample. When you click Check, your browser sends the URL to 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.

Sample result: https://tapcub.com/tools/utm, fetched on 2026-11-17 while this page was built. Click Check to fetch a live copy.

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

hreflangURLSourceStatus
enhttps://tapcub.com/tools/utmHTMLThis page
zh-CNhttps://tapcub.com/zh/tools/utmHTMLOK
x-defaulthttps://tapcub.com/tools/utmHTMLThis page

Return links

Each alternate page as fetched.

hreflangAlternate URLHTTPLinks back?Canonical
zh-CNhttps://tapcub.com/zh/tools/utm200Yes (en, x-default)Self
Suggested tag set
<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.

Parsing and every check run in your browser. The only server involved is check.tapcub.com, which fetches the address you enter when you click Check. Pasted HTML is never sent anywhere. The URL goes into the share link; the page content does not.

Share these inputs: the values go after the # in the link, so they never reach a server.

Version v1.0Updated Update history

Read the result

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.

How to use it

Check one language cluster

Start from any version; the checker follows the links from there.

  1. 1

    Enter one version’s URL

    Use the exact address that should rank in that language.

  2. 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. 3

    Read errors first

    Missing return links, missing self-reference and invalid codes are what make Google ignore the annotations.

  4. 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.

Rules

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 HTTP Link header with rel="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
Typical findings
FindingEffectFix
Alternate does not link backGoogle ignores that pairAdd the same full set to the alternate
Page does not list itselfSet is incompleteInclude a self-referencing link
en-UK, es-419Code is ignoredUse en-GB; list specific countries
href="/de/"Relative URLWrite https://example.com/de/
Alternate redirectsSignals split between two URLsPoint to the final URL
Worked example

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.

Annotations and return links
hreflangURLResult
enhttps://tapcub.com/tools/utmThis page, self-reference present
zh-CNhttps://tapcub.com/zh/tools/utm200, links back as en and x-default, canonical to itself
x-defaulthttps://tapcub.com/tools/utmFallback set to the English page

Three annotations, no errors. The Chinese page carries the same set, so both directions of the pair are confirmed.

Common mistakes

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.

FAQ

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.

Changelog

Update history

New features, fixes and data refreshes for this tool, newest first.

  1. · 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

See your data clearly. Find your growth.

Every click, backed by data. Install one line of code and see your first numbers in a minute.

No credit card · Free plans for analytics and chat · Cookieless analytics