Hreflang-Generator

Sprach-URL-Paare einfügen, ein x-default wählen und ein geprüftes hreflang-Set als <link rel="alternate">-Tags, Sitemap-xhtml:link-Einträge und HTTP-Link-Header erhalten. Prüft Sprachcodes nach ISO 639-1, Schriftcodes nach ISO 15924 und Regionscodes nach ISO 3166-1, fängt en-uk, reine Regions- und dreibuchstabige Codes, doppelte Tags, relative URLs und ein fehlendes x-default ab — jede Seite listet das ganze Set, Rückverweise sind garantiert. Läuft im Browser, nichts wird gespeichert.

6 Zeilen, 6 übernommen. Trennen mit Komma, Tab, Semikolon oder senkrechtem Strich; die Reihenfolge ist egal; Zeilen mit # werden ignoriert.

Die Seite, die erscheint, wenn keine Sprache passt — meist die Sprachauswahl oder die Hauptsprache. Eine ausdrückliche x-default-Zeile in der Eingabe hat Vorrang.

6 Tags im Set · 0 Fehler · 0 Warnungen

Befunde (1)

  • HinweisDas Set umfasst 3 Hosts. Bei ccTLD-Setups normal; prüfen Sie, ob kein Tippfehler vorliegt.

Das Set

hreflangSpracheSchriftRegionURL
dedehttps://www.example.com/de/
de-ATdeAThttps://www.example.at/
enenhttps://www.example.com/
en-GBenGBhttps://www.example.co.uk/
jajahttps://www.example.com/ja/
x-defaultFallbackhttps://www.example.com/

Ausgabe — dasselbe Set auf jede Seite

  <link rel="alternate" hreflang="de" href="https://www.example.com/de/" />
  <link rel="alternate" hreflang="de-AT" href="https://www.example.at/" />
  <link rel="alternate" hreflang="en" href="https://www.example.com/" />
  <link rel="alternate" hreflang="en-GB" href="https://www.example.co.uk/" />
  <link rel="alternate" hreflang="ja" href="https://www.example.com/ja/" />
  <link rel="alternate" hreflang="x-default" href="https://www.example.com/" />

Unverändert in den <head> jeder URL des Sets einfügen. Jede Seite listet alle Alternativen einschließlich sich selbst — das macht die Rückverweise vollständig.

Prüfung und Ausgabe laufen im Browser — keine Anfrage verlässt die Seite, nichts wird gespeichert. Sprach-, Schrift- und Regionscodes werden gegen ISO 639-1, ISO 15924 und ISO 3166-1 geprüft; der Generator meldet, was er findet, und entscheidet nicht, welcher Markt eine Seite braucht.

So funktioniert es

1. Pro Zeile ein Eintrag — Sprach-Tag und absolute URL in beliebiger Reihenfolge, getrennt durch Komma, Tab, Semikolon, senkrechten Strich oder Leerzeichen; Zeilen mit # werden ignoriert; eine x-default-Zeile ist optional
2. Jedes Tag wird in Sprache, Schrift und Region zerlegt (Unterstriche gelten als Bindestriche) und in der Schreibweise normalisiert: Sprache klein (de), Schrift mit Großbuchstaben am Anfang (Hant), Region GROSS (GB)
3. Die Teile werden geprüft — Sprache gegen ISO 639-1 (zwei Buchstaben; iw/in/ji/mo als veraltet markiert), Schrift gegen ISO 15924, Region gegen ISO 3166-1 Alpha-2; en-uk, eine Region allein (us) und dreibuchstabige Codes (eng) werden mit Begründung abgelehnt
4. Die URLs werden geprüft — absolut mit http oder https, parsebar, kein doppeltes Tag über die Zeilen hinweg; dieselbe URL unter zwei Tags ist erlaubt, wird aber markiert, ein Fragment (#) wird markiert
5. x-default wird aufgelöst: eine ausdrückliche Zeile gewinnt, sonst die im Auswahlfeld gewählte Zeile; mehr als ein x-default ist ein Fehler, keines eine Warnung; das ganze Set mit x-default am Ende ist die Ausgabemenge
6. Dasselbe Set wird einmal pro Seite gerendert: <link rel="alternate" hreflang="…" href="…">-Zeilen für den <head>, ein Sitemap-<url>-Block mit xhtml:link-Einträgen für jede URL und ein Link-HTTP-Header für Nicht-HTML-Dokumente — weil jede Seite das volle Set trägt, verweist jede auf jede andere zurück, und Rückverweise können nicht fehlen

Über hreflang und was der Generator prüft

hreflang sagt Google und Yandex, für welche Sprache und optional welche Region eine Seite gedacht ist und wo die entsprechende Seite für andere Zielgruppen liegt. Es ist eine Annotation, keine Weiterleitung: Die Suchmaschine rankt weiterhin die Seite, die sie rankt, kann aber, wenn mehrere Versionen konkurrieren, die zur Sprache und zum Land des Suchenden passende einsetzen. Bing und die meisten anderen Suchmaschinen ignorieren hreflang und lesen stattdessen das HTML-lang-Attribut und den content-language-Header; hreflang ergänzt diese Signale also, statt sie zu ersetzen.

Ein Tag ist ein Sprachcode nach ISO 639-1 — zwei Buchstaben, also en statt eng — optional gefolgt von einer Schrift nach ISO 15924 (zh-Hant, sr-Latn) und einer Region nach ISO 3166-1 Alpha-2 (en-GB, pt-BR). Die Reihenfolge zählt, und die Tabellen auch: Das Vereinigte Königreich ist GB, nicht UK; eine Region kann nicht allein stehen; ein Tag wie es-419 (Lateinamerika) ist ein UN-M.49-Gebietscode, den Google nicht akzeptiert. Der Generator normalisiert die Schreibweise, die Suchmaschinen tolerieren, und lehnt die Teile ab, die schlicht falsch sind und stillschweigend ignoriert würden.

Die Regel, an der die meisten Umsetzungen scheitern, ist die Gegenseitigkeit: Wenn Seite A auf Seite B als ihre deutsche Version zeigt, muss B auf A zurückzeigen, und jede Seite des Sets muss jede andere einschließlich sich selbst auflisten. Ein fehlender Rückverweis lässt Google die Annotation auf beiden Seiten ignorieren. Der Generator umgeht das Problem konstruktiv — er rendert für jede Seite das identische vollständige Set, sodass man es nur falsch machen kann, indem man auf einer anderen Seite ein anderes Set einfügt. x-default benennt die Seite für Besucher, deren Sprache nichts im Set entspricht, typischerweise eine Sprachauswahl oder die Hauptsprache; es ist optional, doch ein Set ohne x-default überlässt diese Entscheidung der Suchmaschine.

Drei Platzierungen leisten dasselbe, und Sie brauchen nur eine: <link>-Tags im <head>, xhtml:link-Einträge in der XML-Sitemap (am besten für große Sites, wo das Bearbeiten von Templates pro Seite unpraktisch ist und die Sitemap ohnehin generiert wird) oder ein Link-HTTP-Header, die einzige Option für PDFs und andere Nicht-HTML-Dateien. Wie auch immer: Die URLs müssen absolut und kanonisch sein — hreflang auf eine weitergeleitete oder nicht kanonische URL wird verworfen. Der Generator meldet, was er findet; ob ein Markt eine eigene Seite verdient, entscheidet er nicht.

Häufige Fragen

Brauche ich x-default?
Es ist optional, aber empfehlenswert, wenn das Set nicht jede Sprache abdeckt, die ein Besucher haben könnte. x-default benennt die URL, die erscheint, wenn keine der aufgeführten Sprachen passt — meist eine Sprachauswahl oder die Seite der Hauptsprache. Der Generator warnt, wenn es fehlt, und lässt Sie jede Zeile als x-default wählen; eine ausdrückliche x-default-Zeile in der Eingabe hat Vorrang vor dem Auswahlfeld.
Warum wird en-uk abgelehnt?
Weil der ISO-3166-1-Code des Vereinigten Königreichs GB lautet. en-uk ist der häufigste hreflang-Tippfehler im Web; Google ignoriert das Tag, statt zu raten. Der Befund zeigt die korrigierte Form en-GB, damit Sie die Quelle berichtigen können.
Kann ich eine Sprache ohne Region und eine Region allein verwenden?
Eine Sprache allein (de) ist gültig und passt auf alle Deutschsprachigen unabhängig vom Land. Eine Region allein (de im Sinne von Deutschland oder us) ist ungültig — hreflang beginnt immer mit einer Sprache. Für Deutschland gezielt de-DE, für Deutschsprachige in der Schweiz de-CH.
Ist es ein Problem, wenn zwei Sprachen auf dieselbe URL zeigen?
Nein. Eine einzelne Seite kann mehrere Tags bedienen — en und en-US auf einer URL oder eine spanische Seite für es, es-ES und es-MX —, solange jedes Tag nur einmal vorkommt. Der Generator markiert eine geteilte URL als Hinweis, damit Sie bestätigen können, dass es beabsichtigt ist, nimmt aber beide Tags in die Ausgabe auf.
Was bedeutet „Rückverweise fehlen“ in der Search Console, und verhindert dieses Tool das?
Es bedeutet, dass Seite A Seite B annotiert, B aber nicht A. Jede Seite eines Sets muss das ganze Set tragen, einschließlich eines Selbstverweises. Dieser Generator gibt für jede URL denselben vollständigen Block aus; unverändert eingefügt kann er keinen fehlenden Rückverweis erzeugen. Der Fehler entsteht nur, wenn Seiten später getrennt bearbeitet werden oder eine URL im Set weiterleitet.
Soll hreflang ins HTML, in die Sitemap oder in den HTTP-Header?
Wählen Sie eins. HTML-<link>-Tags sind für kleine Sites am einfachsten; Sitemap-xhtml:link-Einträge skalieren besser und lassen Templates unangetastet; der HTTP-Link-Header ist die einzige Option für Nicht-HTML-Dateien wie PDFs. Mehrere Platzierungen sind erlaubt, aber jede Abweichung zwischen ihnen gilt als Fehler — das verdoppelt den Pflegeaufwand ohne Gewinn.
Nutzt Bing hreflang?
Bing gibt an, Sprache und Markt einer Seite über das HTML-lang-Attribut, das content-language-Meta-Tag bzw. den HTTP-Header und die URL-Struktur zu bestimmen, nicht über hreflang. Google und Yandex lesen hreflang. Setzen Sie beides: hreflang für Google und Yandex und ein korrektes lang-Attribut für alle anderen.