Cookie-Einstellungen

Notwendige Cookies halten die Seite am Laufen. Analytics zeigt, welche Seiten nützlich sind. Die Wahl lässt sich jederzeit im Footer ändern.

Cookie-Richtlinie dieser Website – alle Details: Cookie-Kategorien, wie wir Ihre Auswahl im Browser speichern und wie Sie Ihre Einwilligung widerrufen.

Notwendig

Grundfunktionen der Seite und Ihre Einwilligung. Immer aktiv.

Analyse

Hilft zu verstehen, wie die Seite genutzt wird. Wird nur nach Ihrer Zustimmung geladen.

GitHubZIP herunterladen

Hreflang-Checker

Prüfen Sie hreflang für eine einzelne URL oder für ein ganzes Set von Seiten: Sprach- und Regionscodes, Selbstverweis, Duplikate, x-default, Rückverweise sowie Alternates, die weiterleiten, fehlschlagen oder noindex tragen.

Auf GitHub ansehenSchnellstart

Was es leistet

  • Terminal: seohead hreflang-check

Über das gesamte Set

Rückverweise und deren Bestätigung erfordern jede Seite des Sets, weil die Prüfung vergleicht, was Seite A über Seite B aussagt, mit dem, was Seite B zurückmeldet. Diese Prüfungen laufen auf Crawl-Daten, etwa einem Screaming-Frog-Export „All Hreflang“, nicht auf einer einzelnen Seite. Außerdem prüfen sie die Alternate-Ziele: ob jedes mit 200 antwortet, indexierbar ist und seine eigene kanonische Version ist.

  • Fehlende Rückverweise und unbestätigte Paare
  • Alternates, die weiterleiten, mit 4xx oder 5xx antworten oder noindex tragen
  • Alternates, die nicht die kanonische Version der Seite sind
  • Alternates, auf die kein interner Link zeigt

Einzelne URL

hreflang-check ruft eine Seite ab, folgt Weiterleitungen und liest die Alternate-Links in deren HTML. Die Prüfung validiert jeden Sprach-, Schrift- und Regionscode, erkennt doppelte Werte und kontrolliert, ob die Seite sich selbst auflistet und ein x-default vorhanden ist. Die Alternates selbst ruft sie nicht auf. Deshalb ist sie ein schneller erster Blick, bevor Sie einen vollständigen Crawl starten.

  • Sprach-, Schrift- und Regionscodes werden gegen ISO 639-1, ISO 15924 und ISO 3166-1 geprüft
  • Selbstverweis und doppelte Werte
  • Vorhandensein von x-default
  • Eine Seite mit 4xx oder 5xx wird als Fehler gemeldet, nicht als sauberes Ergebnis

Platzierung

Ein hreflang-Link zählt nur, wenn der Parser ihn innerhalb des head liest. Ein nativer Crawl vergleicht die Position jedes Alternate-Links und markiert die, die im body landen, oft wegen eines fehlerhaften Tags im head darüber. Mit der Korrektur dieses Tags ist auch die Annotation behoben.

  • Alternate-Links außerhalb des head werden gemeldet
  • Groß- und Kleinschreibung spielt keine Rolle: en-us und en-US sind derselbe Wert
  • Typische Fehler wie en-UK werden erkannt

Drei Schritte, ein gespeicherter Scan

  1. Eine URL live prüfen

    hreflang-check ruft die Seite ab, folgt Weiterleitungen und liest die Alternate-Links in deren HTML. Geprüft werden Codes, Selbstverweis, Duplikate und x-default.

  2. Das Set über einen Crawl prüfen

    Rückverweise, defekte oder weiterleitende Ziele und Ziele mit noindex erfordern jede Seite des Sets. Die Prüfung läuft über einen Screaming-Frog-Export „All Hreflang“ mit seohead sf run, nicht auf einer einzelnen Seite.

  3. Paare korrigieren und erneut prüfen

    Jeder Befund nennt die Seite und das betroffene Alternate. Korrigieren Sie die Auszeichnung auf der Website und führen Sie die Prüfung danach erneut aus.

Prüfungen in dieser Funktion

PrüfungBedeutungSchweregradBeleg
HREFLANG_MISSING_RETURN_LINKEine andere Seite nennt diese URL in ihrem hreflang, diese Seite verweist aber nicht zurückImportantQuellseite und das Alternate ohne Rückverweis (Crawl)
HREFLANG_BROKEN_TARGETEine Alternate-URL antwortet mit dem Status 3xx, 4xx oder 5xxImportantZiel-URL und ihr Statuscode (Crawl)
HREFLANG_NOINDEX_TARGETEine Alternate-URL trägt eine noindex-AnweisungImportantZiel-URL und das noindex-Signal (Crawl)
HREFLANG_INVALID_CODEEin Sprach- oder Regionswert ist kein gültiger Code nach ISO 639-1, ISO 15924 oder ISO 3166-1, zum Beispiel en-UKImportantDer rohe hreflang-Wert und die Seite, auf der er steht (einzelne URL: „malformed hreflang code“)
HREFLANG_MISSING_SELF_REFERENCEDie Seite hat Alternates, aber keines davon ist ihre eigene URLImportantDie Seiten-URL und ihre Alternate-Liste (einzelne URL: „page does not self-reference“)
HREFLANG_MULTIPLE_ENTRIESDerselbe Sprach- und Regionswert erscheint auf einer Seite mehr als einmalImportantDer wiederholte Wert und seine hrefs (einzelne URL: „duplicate hreflang“)
HREFLANG_MISSING_XDEFAULTDas Set hat keinen x-default-Fallback für Nutzer, deren Sprache zu keinem Alternate passtTipDie Seite und ihre Alternate-Liste (einzelne URL: „no x-default alternate“)
Außerdem im Prüfungsregister
HREFLANG_ERRORHREFLANG_INCONSISTENT_CONFIRMATIONHREFLANG_NOT_CANONICALHREFLANG_UNLINKED_TARGETHREFLANG_OUTSIDE_HEAD

Ein Befehl

bash
seohead hreflang-check --url https://example.com/en/

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Eine Seiten-URL für hreflang-check
  • Ein Crawl oder ein Screaming-Frog-Export „All Hreflang“ für die Prüfungen über das gesamte Set
  • Keine API-Schlüssel

Grenzen

  • Die Prüfung einer einzelnen URL ruft die Alternates nicht auf und sieht daher weder deren Statuscodes noch noindex oder Rückverweise
  • Sie liest nur link-Elemente im HTML, nicht hreflang in Sitemaps oder HTTP-Link-Headern
  • Prüfungen über das gesamte Set sind an den hreflang-Exporten von Screaming Frog ausgerichtet; ein nativer Scan behält keine hreflang-Daten
  • Ein gültiger Code beweist nicht, dass die Seite in dieser Sprache verfasst ist

Fragen

Prüft die Einzel-URL-Prüfung jedes Alternate?
Nein. Sie liest die Alternate-Links der Seite und prüft deren Codes, Duplikate, x-default und den Selbstverweis der Seite. Jedes Alternate ruft sie nicht auf. Defekte oder weiterleitende Ziele, noindex-Ziele und fehlende Rückverweise erfordern deshalb einen Crawl.
Verändert sie etwas auf meiner Website?
Nein. Die Prüfung sendet nur lesende GET-Anfragen. Auf der Website wird nichts geschrieben.
Welche Sprachcodes gelten als gültig?
Ein Sprachcode nach ISO 639-1, optional gefolgt von einem Schriftcode nach ISO 15924 und dann einem Regionscode nach ISO 3166-1 alpha-2 oder UN M.49. Groß- und Kleinschreibung spielt keine Rolle, daher sind en-us und en-US derselbe Wert. en-UK wird abgelehnt, weil der Ländercode GB lautet.
Liest sie hreflang aus Sitemaps oder HTTP-Headern?
Die Prüfung einer einzelnen URL liest nur die link-Elemente in der HTML-Antwort. Hreflang, das in einer Sitemap oder einem HTTP-Link-Header deklariert ist, liest dieser Befehl nicht.
Was passiert, wenn die Seite einen Fehler zurückgibt?
Die Prüfung meldet den HTTP-Status und weist darauf hin, dass keine Annotationen zu prüfen waren. Eine Seite mit 4xx oder 5xx erscheint nie als sauberes Ergebnis.
Ist ein fehlendes x-default ein Fehler?
Es ist der mildeste Befund. x-default ist ein Fallback für Nutzer, deren Sprache zu keinem Alternate passt. Er ist nützlich, aber nicht zwingend. Deshalb stuft die Registry ihn als Hinweis ein, unterhalb der Probleme, die die Annotation brechen.

Weiterstöbern

Aus Blog und Glossar

Hreflang: Komplette Anleitung für internationales SEOBlogMehrsprachiges SEO: hreflang, Struktur und LokalisierungBlogHreflangGlossarMehrsprachiges SEOGlossarSprachausrichtungGlossar

Mehr in dieser Gruppe · Audit

Technischer SEO-AuditFunktionWeiterleitungsprüfung: Ketten, Schleifen und 302-WeiterleitungenFunktionBroken-Link-Checker mit Quelle und PositionFunktionCanonical-Tag-PrüfungFunktionStrukturierte Daten und Schema-ValidatorFunktionPrüfung von Title und Meta-DescriptionFunktionPrüfung der ÜberschriftenstrukturFunktionPrüfung auf Duplicate und Thin ContentFunktionImage-SEO-Checker und OptimiererFunktionAudit der internen Verlinkung und Crawl-TiefeFunktionSeitengewicht- und GeschwindigkeitsprüfungenFunktionHTTPS- und Sicherheits-Header-PrüfungFunktionKI-Sichtbarkeit in der Suche (GEO/AEO)Funktion

Testen Sie es auf Ihrer eigenen Website

ZIP herunterladenAlle Funktionen