Dokument enthält kein gültiges hreflang-Element

Viele Websites bieten je nach Sprache oder Region des Nutzers verschiedene Versionen einer Seite an. hreflang-Links teilen Suchmaschinen die URLs für alle Versionen einer Seite mit, damit sie für jede Sprache oder Region die richtige Version anzeigen können.

So schlägt die hreflang-Prüfung von Lighthouse fehl

Lighthouse-Flags enthalten ungültige hreflang-Links:

Lighthouse-Prüfung, bei der falsche hreflang-Links angezeigt werden

Lighthouse sucht nach hreflang-Links in der head der Seite und in ihren Antwortheadern.

Lighthouse sucht dann in den hreflang-Links nach gültigen Sprachcodes. Lighthouse meldet alle hreflang-Links mit ungültigen Sprachcodes.

Lighthouse überprüft weder Regionscodes noch Ihre Sitemap.

Einen hreflang-Link für jede Version einer Seite definieren

Angenommen, Sie haben drei Versionen einer Seite:

  • Eine englische Version unter https://example.com
  • Eine spanische Version für https://es.example.com
  • Eine deutsche Version für https://de.example.com

Es gibt drei Möglichkeiten, Suchmaschinen darüber zu informieren, dass diese Seiten äquivalent sind. Wählen Sie die Methode aus, die sich für Ihre Situation am besten eignet.

Option 1: Fügen Sie der <head> jeder Seite hreflang-Links hinzu:

<link rel="alternate" hreflang="en" href="https://example.com" />
<link rel="alternate" hreflang="es" href="https://es.example.com" />
<link rel="alternate" hreflang="de" href="https://de.example.com" />

Jede Version einer Seite muss mit allen anderen Versionen verknüpft sein, einschließlich der eigenen Version. Andernfalls werden die hreflang-Links von Suchmaschinen möglicherweise ignoriert oder falsch interpretiert.

Verwende bei Seiten, auf denen Nutzer ihre Sprache auswählen können, das Keyword x-default:

<link rel="alternate" href="https://example.com" hreflang="x-default" />

Option 2: Fügen Sie der HTTP-Antwort Link-Header hinzu:

Link: <https://example.com>; rel="alternate"; hreflang="en", <https://es.example.com>;
rel="alternate"; hreflang="es", <https://de.example.com>; rel="alternate"; hreflang="de"

Option 3: Fügen Sie Ihrer Sitemap Informationen zur Sprachversion hinzu.

<url>
<loc>https://example.com</loc>

<xhtml:link rel="alternate" hreflang="es"
href="https://es.example.com"/>

<xhtml:link rel="alternate" hreflang="de"
href="https://es.example.com"/>

</url>

Richtlinien für hreflang-Werte

  • Mit dem Wert hreflang muss immer ein Sprachcode angegeben werden.
  • Der Sprachcode muss dem Format ISO 639-1 entsprechen.
  • Der Wert hreflang kann auch einen optionalen Regionalcode enthalten. Beispielsweise steht es-mx für spanischsprachige Nutzer in Mexiko und es-cl für spanischsprachige Nutzer in Chile.
  • Der Regionscode muss dem Format ISO 3166-1 alpha-2 entsprechen.

Ressourcen