hreflang umsetzen: häufige Fehler und Prüfmethoden

hreflang fehlerfrei über HTML, HTTP-Header und XML-Sitemap einrichten: Sprach-Region-Codes, x-default, Rückverweis, Konflikt mit Canonical und Prüfung auf der Kommandozeile.
Technische Zusammenfassung
Technologie
hreflang, ISO 639-1, ISO 3166-1 alpha-2, XML-Sitemap, HTTP-Link-Header, rel=canonical
Thema
Umsetzung und Prüfung von hreflang auf mehrsprachigen/mehrregionalen Websites
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Festgelegte Struktur der mehrsprachigen Website (Unterverzeichnis, Subdomain oder ccTLD)
  • Zugriff auf Seitenvorlagen oder Sitemap-Erzeugung
  • Ein Crawling-Werkzeug (z. B. Screaming Frog) und Zugriff auf die Search Console
In diesem Beitrag7 Abschnitte

Wird auf einer mehrsprachigen Website einem Nutzer aus Deutschland die türkische Seite gezeigt, ist der hreflang-Cluster das Erste, was man prüft. Diese Auszeichnung teilt der Suchmaschine die Sprach- und Regionalversionen desselben Inhalts mit. Die Einrichtung wirkt einfach; ein einziger fehlender Rückverweis oder ein falscher Regionalcode reicht aber, damit der gesamte Cluster ignoriert wird. Der Fehler ist still: Die Website funktioniert, nur die falsche Version rankt. Dieser Leitfaden beschreibt, wie hreflang nach der Strukturentscheidung fehlerfrei eingerichtet und geprüft wird.

Was hreflang leistet und was nicht

hreflang ist kein Rankingsignal. Es hilft, die richtige Version zu wählen, wenn für dieselbe Suche mehrere Sprachversionen in Frage kommen. Auf der Leistungsseite einer Unternehmenswebsite mit englischer und türkischer Version wird zum Beispiel über hreflang und andere Signale bestimmt, welche Version einem Nutzer aus der Türkei bei einer englischen Suche gezeigt wird.

Was es nicht leistet, ist mindestens ebenso wichtig:

  • Es leitet den Nutzer nicht weiter. Automatische Weiterleitung nach Browsersprache ist eine eigene Umsetzung und wird nicht empfohlen, da sie den Zugriff des Googlebot auf die Versionen behindern kann. Nutzen Sie Links im Sprachumschalter.
  • Es ersetzt nicht das Canonical. Jede Sprachversion trägt ein Canonical auf sich selbst.
  • Es gleicht keine Übersetzungsqualität aus. Seiten, bei denen nur die Vorlagentexte übersetzt sind und der Hauptteil in derselben Sprache bleibt, können als Duplicate Content gewertet werden.

Vor hreflang muss die Strukturentscheidung (Unterverzeichnis, Subdomain oder Länderdomain) getroffen sein. Die Folgen dieser Entscheidung beschreibt der Beitrag Architektur mehrsprachiger Websites. Ohne feste Struktur keine Tags.

Umsetzungsmethoden: HTML, HTTP-Header, Sitemap

Google behandelt alle drei Methoden als gleichwertig. Wählen Sie eine und setzen Sie sie konsistent um; nutzen Sie für denselben Cluster mehrere Methoden, müssen alle exakt dieselbe Information tragen. Stimmen zwei Quellen nicht überein, schauen Sie bei der Fehlersuche zuerst dorthin.

Methode Geeignet für Achtung
HTML-<link> Wenige Sprachversionen, Zugriff auf die Vorlage Mit jeder neuen Sprache wächst der Head aller Seiten
HTTP-Header Link Nicht-HTML-Dateien wie PDF Wird in Server-/CDN-Konfiguration verwaltet, geringe Sichtbarkeit
XML-Sitemap Viele Sprachen oder Seiten Sitemap-Erzeugung muss mit den CMS-Inhalten synchron bleiben

Im HTML-Head

<link rel="alternate" hreflang="tr" href="https://www.example.com/tr/hizmetler/yedekleme/" />
<link rel="alternate" hreflang="en" href="https://www.example.com/en/services/backup/" />
<link rel="alternate" hreflang="de-DE" href="https://www.example.com/de/leistungen/datensicherung/" />
<link rel="alternate" hreflang="x-default" href="https://www.example.com/en/services/backup/" />

Genau dieser Block steht auf jeder Seite des Clusters, und jede Seite listet auch sich selbst. Die Selbstreferenz zu vergessen, gehört zu den häufigsten Lücken, die wir in der Praxis sehen.

Per HTTP-Header

Link: <https://www.example.com/tr/katalog.pdf>; rel="alternate"; hreflang="tr",
      <https://www.example.com/en/catalog.pdf>; rel="alternate"; hreflang="en"

Per XML-Sitemap

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://www.example.com/tr/hizmetler/yedekleme/</loc>
    <xhtml:link rel="alternate" hreflang="tr" href="https://www.example.com/tr/hizmetler/yedekleme/"/>
    <xhtml:link rel="alternate" hreflang="en" href="https://www.example.com/en/services/backup/"/>
    <xhtml:link rel="alternate" hreflang="x-default" href="https://www.example.com/en/services/backup/"/>
  </url>
  <url>
    <loc>https://www.example.com/en/services/backup/</loc>
    <xhtml:link rel="alternate" hreflang="tr" href="https://www.example.com/tr/hizmetler/yedekleme/"/>
    <xhtml:link rel="alternate" hreflang="en" href="https://www.example.com/en/services/backup/"/>
    <xhtml:link rel="alternate" hreflang="x-default" href="https://www.example.com/en/services/backup/"/>
  </url>
</urlset>

Bei der Sitemap-Methode steht jede Sprachversion als eigener <url>-Eintrag, und in jedem Eintrag wird der gesamte Cluster wiederholt. Wird die Namespace-Deklaration xhtml vergessen, ist die Datei kein gültiges XML. Der gesamte Cluster wird nicht gelesen.

Sprach- und Regionalcodes, x-default

Das Format lautet Sprache oder Sprache-REGION. Der Sprachcode muss ISO 639-1 (zwei Buchstaben), der Regionalcode ISO 3166-1 alpha-2 entsprechen. Groß- und Kleinschreibung spielen keine Rolle; de-DE ist zur Lesbarkeit eine verbreitete Konvention. Ein Regionalcode allein ist nicht zulässig: hreflang="gb" für das Vereinigte Königreich ist ungültig, richtig ist en-GB. Ebenso bezeichnet hreflang="de" nicht Deutschland, sondern die deutsche Sprache. Bei Sprachen wie Chinesisch kann ein Schriftsystem-Subtag (zh-Hant, zh-Hans) verwendet werden.

Falsch Richtig Grund
en-UK en-GB Der ISO-Code des Vereinigten Königreichs ist GB
tr-TU tr-TR Der ISO-Code der Türkei ist TR
en-EU en oder länderbezogene Codes EU wird als Ländercode nicht unterstützt
ge (Deutsch) de Der ISO-639-1-Code für Deutsch ist de
tr_TR tr-TR Trennzeichen ist der Bindestrich, nicht der Unterstrich

x-default gibt die Version an, die Nutzern ohne passende Sprache/Region gezeigt wird. Meist wird eine Sprachauswahlseite oder die internationale (meist englische) Version gewählt. Es ist nicht Pflicht, aber empfohlen; besonders wenn es neben regionalen Versionen eine allgemeine Version gibt, verringert es Verwirrung.

Auf WordPress-Seite gibt es eine Falle: Die Ausgabe von get_locale() hat das Format tr_TR. Mehrsprachige Plugins wandeln das um; gibt ein Entwickler, der hreflang manuell in die Vorlage schreibt, diesen Wert aber direkt aus, entstehen ungültige Codes mit Unterstrich. Ein Crawling-Werkzeug zeigt das sofort.

Gegenseitigkeit und Abstimmung mit Canonical

Die hreflang-Beziehung ist zweiseitig: Nennt Seite A Seite B als Alternative, muss B auch A nennen. Eine Beziehung ohne Rückverweis wird ignoriert. Der Grund ist Sicherheit; sonst könnte jede Website eine andere zu ihrer Sprachversion erklären.

Für Canonical gilt eine einfache Regel: Jede in hreflang gelistete URL muss ihre eigene Canonical-URL sein. Die häufigsten Widersprüche in Audits:

  • Das Canonical der englischen Seite zeigt auf die türkische Seite. Die englische Seite wird damit zur „Kopie der türkischen Seite“ erklärt, der Cluster bricht.
  • In hreflang steht eine parametrisierte URL (?lang=en), das Canonical zeigt auf die URL ohne Parameter.
  • In hreflang steht die Version mit http oder ohne abschließenden Schrägstrich, das Canonical mit https und Schrägstrich.

Gelistete URLs müssen 200 liefern, dürfen kein noindex tragen und nicht per robots.txt gesperrt sein. Die allgemeine Nutzung dieser Signale beschreibt der Beitrag Canonical, noindex, robots.txt und Sitemap ausführlich.

Tabelle häufiger Fehler

Fehler Symptom Behebung
Kein Rückverweis „missing return links“ im Crawling-Werkzeug Den Cluster in allen Versionen mit derselben Liste erzeugen
Keine Selbstreferenz Cluster erscheint unvollständig Jede Seite muss auch die Zeile ihrer eigenen Sprache enthalten
Weitergeleitete URL gelistet Ziel liefert 3xx Die endgültige URL mit 200 eintragen
Verweis auf noindex- oder 404-Seite Cluster teilweise ungültig Gibt es keine Version, die Zeile entfernen
Relative URL href="/en/..." Vollständige, absolute URL verwenden
Pauschale Zuordnung zur Startseite Alle englischen hreflang-Einträge führen auf die Startseite /en/ Die echte Entsprechung auf Seitenebene zuordnen; gibt es keine, keine Zeile setzen
Link außerhalb des Head Tag im Body oder nach einem ungültigen Element Möglichst weit oben im Head und in gültigem HTML platzieren

Die letzte Zeile ist besonders tückisch. Ein im Head platziertes ungültiges Element (etwa ein von einem Plugin ausgegebenes <div> oder <img>) kann den Parser des Browsers dazu bringen, den Head vorzeitig zu schließen. Die hreflang-Zeilen ab dieser Stelle bleiben im Body und werden nicht berücksichtigt. Im Quelltext scheinen die Zeilen vorhanden. Prüfen Sie das gerenderte DOM.

Prüfung und Monitoring

Da der frühere Bericht Internationale Ausrichtung in der Search Console entfernt wurde, erfolgt die hreflang-Prüfung weitgehend mit Crawling-Werkzeugen für technisches SEO. Unsere Prüfreihenfolge:

  1. Website-Crawl: Aktivieren Sie in einem Werkzeug wie Screaming Frog SEO Spider die hreflang-Extraktion und crawlen Sie die gesamte Website. Exportieren Sie die Berichte zu fehlenden Rückverweisen, ungültigen Codes, URLs ohne Canonical und Zielen ohne 200.
  2. Sitemap-Prüfung: Wird die Sitemap-Methode genutzt, crawlen Sie die Sitemap als eigene Liste; prüfen Sie, ob im CMS gelöschte Seiten in der Sitemap verbleiben.
  3. Test von Beispielseiten: Führen Sie auf wichtigen Seiten mit dem URL-Prüftool den Live-Test aus und verifizieren Sie, dass die hreflang-Zeilen im gerenderten HTML im Head stehen.
  4. Ergebnismonitoring: Untersuchen Sie die Seiten im Leistungsbericht der Search Console mit Länderfilter. Erhalten bei Seiten mit deutscher Entsprechung im Filter Deutschland die türkischen URLs den Großteil der Impressionen, funktioniert der Cluster möglicherweise nicht.

Für eine schnelle Prüfung auf der Kommandozeile können Sie hreflang-Zeilen, Header und Statuscodes der Ziele einer Seite abrufen:

# hreflang-Zeilen im HTML
curl -s https://www.example.com/tr/hizmetler/yedekleme/ | grep -io '<link[^>]*hreflang[^>]*>'

# HTTP-Link-Header (PDF usw.)
curl -sI https://www.example.com/tr/katalog.pdf | grep -i '^link:'

# Statuscodes der gelisteten Ziele
for u in https://www.example.com/tr/hizmetler/yedekleme/ https://www.example.com/en/services/backup/; do
  printf '%s %s\n' "$(curl -s -o /dev/null -w '%{http_code}' "$u")" "$u"
done

Ergänzen Sie auch eine dauerhafte Prüfung: Werden die hreflang-Zeilen in den anderen Sprachen automatisch aktualisiert, wenn eine Sprachversion gelöscht wird oder sich ihr Slug ändert? Manuell gepflegte Cluster sind bei Website-Umzügen die am häufigsten brechenden Strukturen; wie diese Prüfung beim Umzug erfolgt, beschreibt der Beitrag SEO-Verluste beim Website-Umzug verhindern. Die offizielle Definition der Regeln finden Sie in der Google-Dokumentation zu lokalisierten Versionen.

Auf einer mehrsprachigen Website lässt sich hreflang nicht vom Inhaltsmodell trennen. Die Zuordnung zwischen Versionen als Daten im CMS zu führen, ist die erste Struktur, die wir in Projekten für mehrsprachige und mehrregionale Websites aufbauen. Steht die Zuordnung in den Daten, ist das Tag automatisch richtig.

Häufig gestellte Fragen

Braucht eine einsprachige Website hreflang?

Nein. hreflang ist nur sinnvoll, wenn es Sprach- oder Regionalversionen desselben Inhalts gibt; auf einer einsprachigen Website bringt eine einzelne Selbstreferenz nichts. Das Attribut html lang richtig zu setzen, ist für Barrierefreiheit und Browser dennoch nötig, Google gibt aber an, sich bei der Spracherkennung nicht auf dieses Attribut zu stützen.

Sollte ich für eine türkische Seite tr oder tr-TR schreiben?

Zielt der türkische Inhalt nur auf die Türkei, sind beide gültig. Zielen Sie auch auf türkischsprachige Nutzer in anderen Ländern und gibt es keine eigene regionale Version, ist der reine Sprachcode tr umfassender. Die eigentliche Regel ist, den gewählten Code im gesamten Cluster einheitlich zu verwenden.

Ersetzt hreflang Weiterleitung oder Canonical?

Nein. hreflang leitet den Nutzer nicht weiter und löst Duplicate Content nicht allein; es gibt nur einen Hinweis, welche Version welchem Nutzer gezeigt werden soll. Jede Sprachversion trägt weiterhin ein Canonical auf sich selbst.

Wie lange dauert es nach einer Änderung, bis sich die Ergebnisse korrigieren?

Eine feste Dauer gibt es nicht. Google muss alle Seiten im Cluster neu crawlen; bei selten gecrawlten Seiten dauert das länger. Die Sitemap zu aktualisieren und wichtige URLs mit dem URL-Prüftool zu kontrollieren, erleichtert die Verfolgung.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge