Skip to main content

Hreflang Health

Hreflang Health is an Addon for sites running a translation plugin, WPML, Polylang, or TranslatePress. It audits the translation-link data those plugins already use to build their own hreflang tags, and flags issues that would cause search engines to ignore or misread your multilingual setup.

note

Hreflang Health never outputs any hreflang tags itself. WPML, Polylang, and TranslatePress all generate their own tags automatically. A second generator would create duplicate or conflicting tags, so this addon only reads and validates what is already there.


Availability

The Hreflang Health card only appears on the Addons page if at least one of the following plugins is detected as active:

  • WPML
  • Polylang
  • TranslatePress

On single-language sites, the card is completely hidden to avoid clutter.


What it checks

CheckDescription
Broken translation targetsTranslation links that point to a page that has been deleted or moved to the trash
Duplicate language codesTwo pages within the same translation group both claiming the same language code
Invalid language codesLanguage codes that don't conform to the BCP 47 / ISO 639-1 format used by Google

Using the addon

  1. Go to Minorank SEO → Addons in the WordPress admin.
  2. Find the Hreflang Health card and toggle it on.
  3. Click Settings to see the current audit results.

Issues are listed with the affected post title, the problem type, and a link to the edit screen so you can fix the source data in your translation plugin.


Fixing issues

IssueFix
Broken translation targetEither restore the deleted page or remove the translation link in your translation plugin
Duplicate language codeIn your translation plugin, check the translation group and remove the duplicate language assignment
Invalid language codeUpdate the language settings in WPML / Polylang / TranslatePress to use a valid BCP 47 code (e.g. en, el, fr-CA)