SEO

Hreflang Tag Checker

Details

How to use Hreflang Tag Checker

What the tool does, how to run it, and what to expect from the result.

How to check hreflang tags

To check your hreflang tags, copy the page HTML or just the head markup and paste it into the checker. It extracts every link rel=alternate hreflang entry, lays out the language-and-region mapping in one view, and flags the issues that commonly break international targeting.

The checker runs entirely in your browser, so the markup you paste is never sent to a server. That makes it safe for staging pages and unpublished templates, and it works instantly without an account.

  • Paste full HTML or just the head markup
  • Review the alternate language and region mapping
  • Check flags for duplicate or suspicious codes
  • Confirm an x-default entry is present

What hreflang problems it catches

Hreflang mistakes are easy to make and hard to spot by eye. This checker surfaces duplicate hreflang codes pointing at different URLs, values that do not look like valid language or region codes, and the absence of an x-default entry when multiple alternates exist, which is one of the most common oversights.

It is deliberately a heuristic, paste-based tool rather than a full site crawler. It checks the markup you give it and flags obvious issues clearly, without pretending to validate return tags across an entire live site. That keeps it fast and honest for a pre-launch review.

Tips

Getting a better result out of Hreflang Tag Checker

Specific settings and thresholds, not general advice.

  • The accepted shape is x-default, or a two to three letter language code with an optional region suffix of two to eight characters. en-US passes, en_US with an underscore is flagged, and a word like english is flagged because it exceeds three letters.
  • The check is shape only, not a dictionary lookup. Codes like zz and en-ZZ pass because they look structurally correct, even though neither is a real ISO 639-1 language or ISO 3166-1 region.
  • hreflang='uk' does not mean the United Kingdom. It is the language code for Ukrainian. The country code you want is GB, as in en-GB, and this checker will pass 'uk' without complaint because the shape is valid.
  • The single most common hreflang failure is a missing return link. Every page in a cluster must reference every other page including itself, and a one-way reference is ignored. This tool only ever sees the markup you pasted, so it cannot confirm the other side of the pair.
  • hreflang and canonical must agree. If a German page canonicalizes to the English version while also declaring itself the de alternate, the cluster is self-contradictory and Google discards the annotations.
Limits

What Hreflang Tag Checker does not do

The honest boundary, so you do not lose time finding it yourself.

  • Reads link rel=alternate elements from pasted markup only. hreflang delivered in an XML sitemap or an HTTP header is not read.
  • Cannot verify return links, which is the error that breaks most real hreflang setups.
  • Validates the shape of a code, not its existence. It does not check codes against ISO 639-1 or ISO 3166-1.
  • Does not fetch the alternate URLs, so it cannot see that one of them 404s, redirects, or carries a conflicting canonical.
At a glance

Who Hreflang Tag Checker is for

A quick way to understand who this helps, what it solves, and where it connects next.

Best fit

International SEO teams, developers, and publishers reviewing multi-language metadata before shipping.

Ideal for

Practical hreflang QA without a remote crawler or rendering simulation.

FAQ

Common questions

Short answers for the questions people usually have before trying a utility like this.

Is this hreflang checker free?

Yes. This hreflang tag checker is free to use with no sign-up, and you can check as many pages as you like.

Does it upload my HTML to a server?

No. The HTML or head markup you paste is parsed entirely in your browser, so it stays private and is never uploaded.

Does it check the linked pages too?

No. This checker validates only the markup you paste. It does not crawl or fetch the alternate URLs to verify their return tags.

Does it warn about missing x-default?

Yes. When multiple alternate entries are present, the checker surfaces a missing x-default as a practical note so you can add one.

Can I check staging or unpublished pages?

Yes. Because everything runs in your browser and nothing is uploaded, you can safely paste markup from staging or draft pages.

Is en-UK a valid hreflang value?

No, and it is a very common mistake. The region code for the United Kingdom is GB, so the correct value is en-GB. This checker accepts en-UK because it has the right shape, which is a good illustration of why a shape check is not a validity check.

Do I need an x-default entry?

It is optional but useful. x-default tells search engines which page to serve when no declared language or region matches the user. Without it, a visitor whose locale is not in your cluster gets whichever page the engine guesses. The checker raises a note, not a warning, when two or more alternates exist with no x-default.

Do the tags have to be on every page in the set?

Yes. hreflang is bidirectional. If the English page lists the German alternate but the German page does not list the English one back, the annotation is dropped entirely. Every page in the cluster must list every page in the cluster, itself included.

Can I put hreflang in the sitemap instead of the head?

Yes. XML sitemaps with xhtml:link entries are a supported alternative, and are often easier to maintain for large sites because the mapping lives in one file rather than in thousands of templates. This tool does not read that format; it inspects head markup only.

Does it fetch the alternate URLs?

No, and that is the honest limit of any paste-based hreflang checker. Everything runs in your browser on the text you supplied. Verifying return links, response codes and canonical agreement requires crawling every URL in the cluster.

Should hreflang URLs match the canonical of each page?

Yes. Each hreflang URL should be the self-referencing canonical of the page it points at. Pointing hreflang at a URL that canonicalizes somewhere else sends two conflicting signals, and search engines resolve the conflict by ignoring the hreflang.

Recommendations

You Might Also Like

Nearby tools from the catalog that fit the same job or workflow.

Cleanor app

Do it all on your device

Cleanor puts these tools in one app: compress and convert images, video, and audio, work with PDFs, and scan text right on your device. Plus free up storage and clear inbox clutter with Email Cleaner. Start with a free trial.

  • iPhone
  • Android
  • Macsoon
  • Windowssoon