Skip to main content
All rules

SEO-020

hreflang links are invalid

MediumDefault severity · SEO / Quality · SEO, quality and performance

Last reviewed

What it checks

Language codes and URLs of <link rel="alternate" hreflang> tags.

Why it matters

Search engines ignore invalid hreflang annotations, so visitors may land on the wrong language version.

Recommended fix

Use ISO language codes (en, en-GB, pt-BR, x-default) and absolute URLs.

How to verify

Check the page in an hreflang validator and confirm no errors.

Example fix prompt

Generic prompt (your report adds the evidence)
Please fix this production issue in my app.

Issue SEO-020: hreflang links are invalid
Site: https://your-app.example

First confirm the issue in the code or live config. If it is not present, say so and change nothing.
Task: Fix the hreflang tags in the evidence: valid language(-region) codes such as en, en-GB or x-default, and absolute https:// URLs for every alternate.

Constraints: make the smallest change that fixes this, keep the current design and behaviour, never paste secret values into code or chat, and tell me which files you changed.
Done when: Check the page in an hreflang validator and confirm no errors.

References