hreflang lang mismatch

warning hreflang-lang-mismatch hreflang and language versions

The declared language does not match the language the page is actually written in. This is the failure that sends a Spanish reader to an English page and counts as a correct result.

What indexgap reports

The finding reads:

warning  hreflang-lang-mismatch  the self-reference is declared as “…” while the page declares lang=“…”

How to fix it

Bring the declared language in line with the language the text is written in. While they disagree, the engine shows the page to the wrong readers — and counts that as a correct result.

How it behaves at scale

Collapsed when it fires template-wide. If it appears on 90% or more of the pages — or of one language version — of a site with at least 20 pages, it is a property of the template and is reported once, with the count, instead of once per page.

Finding it

pipx install indexgap
cd your-project
indexgap init
indexgap check

Then indexgap brief turns every finding on this page into a work order in indexgap-briefs/, with the thresholds the result has to satisfy and the command to check it.

Related checks in hreflang and language versions

All checks · hreflang and language versions