Zahid Awais Get a free audit

Free hreflang tag checker

Paste the head code of one or more language versions and get a clear report of every hreflang problem, page by page.

By Zahid Awais · Technical SEO tools · Free, private, no sign-up

Paste view-source code or just the link tags. If a page has no URL: line, its canonical URL is used as the page address. Nothing is fetched and nothing leaves your browser.

Result
0Pages
0Hreflang tags
0Errors
0Warnings
PageTagsSelfx-defaultIssues
    Hreflang Tag Checker: what it does and an example result

    The free hreflang checker reads the head code or link tags you paste for one or more language versions of a page and reports every problem: invalid language or region codes, missing self-references, missing return links between the pasted pages, relative URLs, a missing x-default and canonical tags that point to another language.

    Quick answer

    An hreflang checker tests whether the hreflang tags on your language versions follow Google's rules: ISO 639-1 language codes with optional ISO 3166-1 alpha-2 regions, fully-qualified URLs, a self-reference on every page and return links between all versions. Google may ignore annotations without return links, so fix those first.

    What does an hreflang checker check?

    An hreflang checker reads the <link rel="alternate" hreflang="..."> tags of each language version and tests them against the rules in Google's guide to localized versions of your page. This tool checks the syntax of each tag, every code against built-in ISO 639-1, ISO 3166-1 alpha-2 and ISO 15924 lists, whether each page lists itself, whether the pages you pasted link back to each other, and whether the canonical tag agrees with the hreflang set.

    It does not fetch anything. Paste the head of each version from view-source, or only the link tags, with a URL: line above each page so the tool knows which address the code belongs to. That makes it work for staging sites, pages behind a login and templates you have not published yet. To write a correct set from scratch, use the hreflang tag generator.

    How do you use the Hreflang Tag Checker?

    How to use the Hreflang Tag Checker: enter details, see the result and copy it
    Real screenshot of the Hreflang Tag Checker with the example input from this page.
    1. Open each language version, view the page source and copy the head section, or only the hreflang and canonical link tags.
    2. In the box, type URL: and the page address on its own line, then paste that page's code under it. Repeat for every version.
    3. Read the summary table: tags per page, whether each page lists itself, whether it has x-default, and how many issues it has.
    4. Work through the report from the top. Errors, such as missing return links or invalid codes, can make Google ignore the tags.
    5. Fix the templates or the CMS setting that writes the tags, paste the new code and check again, then copy the report for your developer.

    What are return links in hreflang?

    Return links are the hreflang tags that point back from each alternate to the page that listed it. If page X lists page Y, page Y must list page X. Google says "if two pages don't both point to each other, the tags will be ignored", and lists missing return links first among the common mistakes. The rule exists so another site cannot claim your pages as its alternates. This checker compares every pasted page with every other one and reports each missing link on the page that lacks it.

    Which hreflang code mistakes are most common?

    The most common are a region code on its own, such as gb or jp, a reserved region such as en-UK, three letter language codes, underscores as in en_GB, and numeric regions such as es-419. Google says "you can't specify the country code by itself", that codes like es-419 "aren't supported", and that using EU, UN or UK "doesn't have an effect on Google Search". Some valid codes catch people out too: uk means Ukrainian and se means Northern Sami, so the tool adds a warning when it sees them.

    How should canonical tags work with hreflang?

    Each language version should be canonical to itself, and the hreflang tags should list those canonical URLs. Google's canonical URL guide says: "If you're using hreflang elements, make sure to specify a canonical page in the same language, or the best possible substitute language if a canonical page doesn't exist for the same language." A French page that is canonical to the English page sends mixed signals, so the checker reports it as an error. It also flags hreflang placed on a rel="canonical" tag, which Google does not use for canonicalization.

    Quick reference: what the checker reports

    CheckError whenGoogle rule
    CodesNot ISO 639-1, region alone, en-UK, es-419, en_GBISO 639-1 language, optional ISO 3166-1 alpha-2 region
    URLsRelative (/de/) or protocol-relative (//example.com/de/)Alternate URLs must be fully-qualified
    Self-referenceThe page does not list its own URLEach version lists itself and all others
    Return linksA pasted page does not link backPages must point to each other
    Duplicate codesOne code points to two URLsOne URL per code
    PlacementTag in the body, or combined with mediaInside a well-formed head; no media in the same tag
    CanonicalCanonical points to another languageCanonical in the same language
    x-defaultMissing (warning only)Optional fallback for unmatched languages

    Worked example

    Example

    Example: the default input has the English home page, the German page and the French page of www.example.com. The checker finds 3 pages, 11 hreflang tags, 4 errors and 1 warning, all on the French page. Its canonical points to the English page, its en-UK tag uses a reserved region code, its German link is the relative URL /de/, and so the German page has no return link from it. The English and German pages pass with no issues. The warning says the French page has no x-default.

    Learn more

    Frequently asked questions

    Why does the checker not fetch my pages?

    Fetching other sites from a browser page is blocked by browser security rules unless a server helps, and this tool runs entirely in your browser. Pasting the code also lets you check staging sites and pages that are not public yet.

    Do I need to paste every language version?

    For a full return link check, yes. The tool checks return links only between pages you paste. Alternates you did not paste are counted in a note, so you know which pages still need checking.

    Is a missing x-default an error?

    No. Google treats x-default as optional. It is the fallback for users whose language or region matches none of your versions, and it suits language selector pages best. The checker reports a missing x-default as a warning only.

    Are hreflang codes case-sensitive?

    No. Google says the hreflang value is case-insensitive, so en-gb and en-GB both work. Writing the region in uppercase follows the ISO convention and is easier to read, so the tool shows codes in that form.

    My hreflang is in the sitemap. Can I check it here?

    This tool checks HTML link tags. For sitemap hreflang, rebuild the file with the hreflang sitemap generator, which writes every alternate for every URL. Avoid keeping different hreflang sets in the HTML and the sitemap.

    Does hreflang decide which language Google thinks a page is in?

    No. Google says it does not use hreflang or the HTML lang attribute to detect the language of a page. Hreflang tells Google which URLs are alternates, so it can show users the version that matches their language.

    Sources

    Checked 23 Oct 2026. Facts checked against these official pages. Read how I check facts in my editorial policy.

    Related free tools

    All free tools

    Hreflang Tag Generator

    A hreflang tag generator is a tool that writes rel="alternate" hreflang annotations so search engines can…

    Canonical Tag Generator

    A canonical tag generator is a tool that builds the link rel="canonical" element telling search engines which…

    Want a full audit instead?

    Send your website and I will check it for you, free.

    Get my free audit
    Chat on WhatsApp
    Free updates

    Get new tools, guides and coupons first

    One short email when something new goes live: articles, free SEO tools, package updates, discounts and price alerts. No spam, unsubscribe in one click.