HTML lang attribute does not match content language — the fix
The lang attribute on the <html> element does not match the actual language of the page content or the hreflang annotation for this page. This sends conflicting language signals.
Where this fits: indexability in SEO
Indexability is whether a crawled page is allowed into the search index at all. A page can be perfectly reachable and still tell Google to ignore it — through a noindex directive, a conflicting canonical, or an X-Robots-Tag header set by the server. These directives are absolute: one stray meta tag removes a page from search entirely. Indexability issues are the most binary in SEO — the page either can rank or it cannot — which is why they sit at the top of every serious audit.
Why html lang attribute does not match content language hurts your rankings
Conflicting language signals confuse search engines about which language the page is written in, potentially causing it to appear in wrong-language search results. Screen readers will also use incorrect pronunciation rules, degrading accessibility for visually impaired users.
This is a medium-severity issue: individually modest, but it compounds — dozens of medium issues across hundreds of pages add up to a real quality deficit in how search engines assess the site.
How to fix it
Update the html lang attribute to match the primary language of the page content. Ensure it is consistent with hreflang annotations and the Content-Language header if present.
Indexability best practices
- Audit noindex directives after every deploy — one templating mistake can deindex a section overnight.
- Give every indexable page exactly one self-referencing canonical URL.
- Never mix signals: a page should not be canonicalised away AND noindexed AND in the sitemap.
- Use hreflang pairs that reciprocate; a one-way hreflang is ignored.
- Check the HTTP layer too — X-Robots-Tag headers override what you see in the HTML.
The full library: SEO best practices, by category.
Frequently asked questions
What does "HTML lang attribute does not match content language" mean?
The lang attribute on the <html> element does not match the actual language of the page content or the hreflang annotation for this page. This sends conflicting language signals.
Why does html lang attribute does not match content language matter for SEO?
Conflicting language signals confuse search engines about which language the page is written in, potentially causing it to appear in wrong-language search results. Screen readers will also use incorrect pronunciation rules, degrading accessibility for visually impaired users.
How do I fix html lang attribute does not match content language?
Update the html lang attribute to match the primary language of the page content. Ensure it is consistent with hreflang annotations and the Content-Language header if present.
How serious is this issue?
This is a medium-severity issue: individually modest, but it compounds — dozens of medium issues across hundreds of pages add up to a real quality deficit in how search engines assess the site. It belongs to the indexability family of checks.
How do I find every page affected by this on my site?
Run a free Dr Urls audit: it crawls your site, detects html lang attribute does not match content language on every affected page, shows example URLs, and generates a ready-to-use fix task. Re-scan after fixing to verify the issue is gone.
Does your site have this issue?
A free Dr Urls audit crawls your site, finds every page affected by html lang attribute does not match content language, and hands you a ready-made fix task.
Check my site free