hreflang.invalid-code
hreflang values that are not valid ISO 639-1 language codes with an optional ISO 3166-1 region (or x-default).
What to change
Use codes like "en", "en-gb", "nl-nl", "zh-hant" or "x-default". Country codes alone ("uk", "eu") are invalid.
The documentation on developers.google.comA finding of this rule on a page carries the exact edits for that page: the markup it quotes, and what to write instead.
When it runs
Runs on every SEO audit: of a page, a crawl, a build directory or HTML. A warning is a problem that costs a page ranking, clicks or citations. Each finding takes 5 points off the page's score.
The severity here is the rule's usual one: a finding can be raised or lowered when the page gives a reason.
Run it, or skip it
Check a page for this rule alone, after a fix for instance:
npx @rivi-software/agentic-seo-check audit https://example.com --rule hreflang.invalid-code
Or from an assistant, with the MCP tool seo_audit_page:
{
"url": "https://example.com",
"rules": [
"hreflang.invalid-code"
]
}
To leave it out of an audit, pass --disable hreflang.invalid-code on the command, or disableRules: ["hreflang.invalid-code"] to a tool.
More in hreflang and languages
All 6 rules- Warning
hreflang.relative-urlhreflang links must use absolute URLs. - Warning
hreflang.duplicate-langThe same hreflang value appears more than once with different URLs. - Warning
hreflang.missing-selfThe hreflang set does not include this page itself (self-referencing entry). - Info
hreflang.missing-x-defaultThe hreflang set has no x-default entry. - Warning
hreflang.canonical-other-languageThe canonical points to an hreflang alternate in another language, so search engines treat this page as a copy of that one and leave it out of the index.