Die häufigsten Fehler vermeiden
Falsch implementiertes hreflang führt dazu, dass Google Nutzern die falsche Sprachversion einer Seite anzeigt und mehrsprachige Inhalte fälschlich als Duplicate Content einstuft. Dieser Artikel erklärt Syntax und Rückverlinkungspflicht von hreflang, den korrekten Einsatz von x-default sowie die häufigsten Fehlerquellen und zeigt anhand des mironsoft.de Blogs, wie eine saubere Implementierung in der Praxis aussieht.
Inhaltsverzeichnis
- 1. Was hreflang ist und welches Problem es löst
- 2. hreflang-Syntax: Sprachcodes, Regionscodes und Platzierung
- 3. Die Rückverlinkungspflicht: Warum hreflang immer reziprok sein muss
- 4. x-default: Zweck und korrekte Nutzung
- 5. Häufiger Fehler 1: Fehlende oder fehlerhafte Rückverlinkung
- 6. Häufiger Fehler 2: Falsche oder inkonsistente Sprach- und Regionscodes
- 7. Häufiger Fehler 3: Konflikte mit Canonical und nicht-indexierbare Ziel-URLs
- 8. Testen und Validieren der hreflang-Implementierung
- 9. Praxisbeispiel: hreflang im mironsoft.de DE/EN-Blog
- 10. Zusammenfassung
- 11. FAQ
1. Was hreflang ist und welches Problem es löst
hreflang ist ein Attribut, mit dem Website-Betreiber Google und anderen Suchmaschinen mitteilen, welche Sprach- und Regionsvarianten einer Seite existieren und wie diese Varianten zusammenhängen. Ohne hreflang behandelt Google jede Sprachversion als eigenständige, potenziell konkurrierende Seite: Bei einem zweisprachigen Blog wie mironsoft.de würde das bedeuten, dass der deutsche und der englische Artikel um dieselben Rankingpositionen konkurrieren, obwohl sie denselben Inhalt für unterschiedliche Zielgruppen bereitstellen. Das Ergebnis ist ein Duplicate-Content-Signal, das die Sichtbarkeit beider Sprachversionen unnötig schwächt.
Der eigentliche Nutzen von hreflang liegt jedoch nicht in der Vermeidung von Duplicate Content allein, sondern in der korrekten Sprachauslieferung: Google zeigt einem Nutzer in Deutschland im Idealfall automatisch die deutsche Version, während ein Nutzer in den USA die englische Version im Suchergebnis sieht, selbst wenn beide nach demselben Suchbegriff suchen. Für internationale Magento-Shops mit mehreren Store Views ist das kein Nice-to-have, sondern eine Grundvoraussetzung, um in jedem Zielmarkt mit der passenden Sprache und Währung sichtbar zu sein, statt Traffic durch falsch zugeordnete Sprachversionen zu verlieren.
2. hreflang-Syntax: Sprachcodes, Regionscodes und Platzierung
Die Grundsyntax von hreflang besteht aus einem <link>-Element mit rel="alternate" und einem hreflang-Attribut, dessen Wert sich aus einem ISO 639-1 Sprachcode (zweistellig, z. B. de oder en) und optional einem ISO 3166-1 Regionscode (ebenfalls zweistellig, z. B. DE oder US) zusammensetzt, getrennt durch einen Bindestrich. de zielt auf alle deutschsprachigen Nutzer weltweit, de-DE ausschließlich auf Nutzer in Deutschland und de-AT ausschließlich auf Nutzer in Österreich. Der Regionscode ist optional und sollte nur gesetzt werden, wenn tatsächlich unterschiedliche Inhalte für unterschiedliche Regionen derselben Sprache existieren.
hreflang lässt sich an drei Stellen ausliefern: im <head> der HTML-Seite als <link>-Element, als Link-HTTP-Header (relevant für Nicht-HTML-Ressourcen wie PDFs) oder als Eintrag in der XML-Sitemap. Alle drei Methoden sind für Google gleichwertig, dürfen aber nicht gemischt werden, ohne konsistent zu sein: Wer hreflang im Head und in der Sitemap parallel pflegt, riskiert widersprüchliche Angaben bei jeder Aktualisierung. Für Magento-Shops mit wenigen Store Views ist die Head-Variante am wartungsfreundlichsten, bei sehr großen Katalogen mit vielen Sprachvarianten reduziert die Sitemap-Variante die HTML-Dateigröße spürbar.
<!-- HTML head: reciprocal hreflang for DE, EN and x-default -->
<link rel="canonical" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen">
<link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen">
<link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/seo-implementing-hreflang-correctly">
<link rel="alternate" hreflang="x-default" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen">
<!-- The English page must confirm the exact same set, pointing back -->
<link rel="canonical" href="https://mironsoft.de/blog/seo-implementing-hreflang-correctly">
<link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen">
<link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/seo-implementing-hreflang-correctly">
<link rel="alternate" hreflang="x-default" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen">
<!-- XML sitemap: hreflang entries as an alternative to head markup -->
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen</loc>
<xhtml:link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen"/>
<xhtml:link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/seo-implementing-hreflang-correctly"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen"/>
</url>
<url>
<loc>https://mironsoft.de/blog/seo-implementing-hreflang-correctly</loc>
<xhtml:link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen"/>
<xhtml:link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/seo-implementing-hreflang-correctly"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen"/>
</url>
</urlset>
3. Die Rückverlinkungspflicht: Warum hreflang immer reziprok sein muss
Googles Dokumentation verlangt explizit, dass jede hreflang-Annotation reziprok bestätigt wird: Verweist Seite A per hreflang auf Seite B, muss Seite B im Gegenzug per hreflang auf Seite A zurückverweisen. Diese Rückverlinkung ist kein optionales Detail, sondern die eigentliche Vertrauensbasis des gesamten Systems. Ohne sie kann Google die Sprachbeziehung nicht verifizieren und ignoriert die hreflang-Angabe der einseitig verlinkenden Seite komplett, nicht nur teilweise.
In der Praxis bedeutet das für jedes Sprachpaar mindestens zwei sich gegenseitig bestätigende Einträge, bei drei oder mehr Sprachvarianten wächst die Anzahl der notwendigen Links quadratisch: Bei fünf Sprachversionen einer Seite braucht jede Variante vier ausgehende hreflang-Links, die allesamt zurückbestätigt werden müssen. Diese Komplexität ist der Hauptgrund, warum manuelle Pflege von hreflang bei mehr als zwei Sprachen fehleranfällig wird und warum eine dynamische, code-generierte Lösung, etwa über ein Magento ViewModel, das pro Store View automatisch alle Store-View-URLs auflistet, der einzig robuste Ansatz für wachsende Shops ist.
4. x-default: Zweck und korrekte Nutzung
hreflang="x-default" ist ein Sonderwert, der keine bestimmte Sprache adressiert, sondern die Seite markiert, die Google Nutzern zeigen soll, deren Sprache oder Region zu keiner der explizit definierten Varianten passt, etwa ein Besucher aus Frankreich auf einem Shop, der nur Deutsch und Englisch anbietet. Typischerweise zeigt x-default auf eine Sprachauswahlseite oder auf die global neutralste Version des Inhalts, häufig die englische Variante.
Ein verbreiteter Fehler ist, x-default wegzulassen oder es fälschlich als zusätzliche Sprachvariante statt als Fallback zu behandeln. Ohne x-default entscheidet Google bei nicht abgedeckten Sprachen und Regionen selbstständig, welche Variante angezeigt wird, meist basierend auf Popularität oder Relevanzsignalen, was selten der gewünschten Nutzererfahrung entspricht. Für mironsoft.de zeigt x-default sinnvollerweise auf die deutsche Version, da Deutsch die primäre Zielsprache der Agentur ist und Englisch als internationale Zweitsprache dient. Diese Entscheidung sollte immer auf Basis der tatsächlichen Zielgruppenverteilung getroffen werden, nicht willkürlich.
5. Häufiger Fehler 1: Fehlende oder fehlerhafte Rückverlinkung
Der mit Abstand häufigste hreflang-Fehler in der Praxis ist die asymmetrische Verlinkung: Seite A verlinkt korrekt auf Seite B, aber Seite B wurde nach einem Redesign, einer URL-Änderung oder schlicht aus Versehen nie mit dem Rückverweis auf Seite A versehen. Google meldet diesen Fehler in der Search Console unter Hinweisen zu fehlenden Rückverweisen. Wird er ignoriert, verliert die betroffene hreflang-Beziehung ihre komplette Wirkung, und beide Seiten laufen wieder Gefahr, als konkurrierender Duplicate Content behandelt zu werden.
Besonders tückisch ist dieser Fehler bei URL-Migrationen: Wird eine deutsche Blogseite umbenannt, ohne den entsprechenden hreflang-Verweis in der englischen Schwesterseite anzupassen, bleibt die englische Seite auf eine tote oder falsche URL verlinkt. Automatisierte Tests, die bei jedem Deployment alle hreflang-Paare auf Reziprozität prüfen, verhindern dieses Problem zuverlässiger als manuelle Kontrolle, gerade bei Blogs oder Kategorieseiten, die regelmäßig aktualisiert werden.
<!-- BROKEN: asymmetric hreflang, page A links to B, but B never links back -->
<!-- Page A (DE) head: -->
<link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/alte-seite-de">
<link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/neue-seite-en">
<!-- Page B (EN) head after a URL rename, still using the outdated slug: -->
<link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/alte-seite-de">
<link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/alte-seite-en">
<!-- Mismatch: page A expects "neue-seite-en", page B still self-references the old EN slug -->
<!-- FIXED: both pages reference the exact same, current URLs -->
<!-- Page A (DE) head: -->
<link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/alte-seite-de">
<link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/neue-seite-en">
<!-- Page B (EN) head: -->
<link rel="alternate" hreflang="de" href="https://mironsoft.de/blog/alte-seite-de">
<link rel="alternate" hreflang="en" href="https://mironsoft.de/blog/neue-seite-en">
6. Häufiger Fehler 2: Falsche oder inkonsistente Sprach- und Regionscodes
Ein zweiter verbreiteter Fehler ist die Verwechslung von Sprach- und Regionscodes: hreflang="de-DE" ist korrekt, hreflang="DE-de" oder hreflang="deu" sind es nicht, weil Google nur validierte ISO-639-1-Sprachcodes in Kleinschreibung und ISO-3166-1-Regionscodes in Großschreibung akzeptiert. Ein weiterer klassischer Fehler ist die Verwendung eines Ländercodes anstelle eines Sprachcodes, etwa hreflang="uk" für britisches Englisch: uk ist kein gültiger Sprachcode, korrekt ist en-GB, da UK kein ISO-3166-1-Ländercode für das Vereinigte Königreich ist. Der korrekte Ländercode lautet GB.
Inkonsistenz zwischen den Codes derselben Sprachversion ist ebenfalls ein häufiges Problem: Wenn eine Seite sich selbst im Sitemap-Eintrag als en referenziert, aber im HTML-Head als en-US, entstehen zwei technisch unterschiedliche hreflang-Ziele für denselben Inhalt, die Google nicht zuverlässig zusammenführen kann. Die Regel lautet daher: einen Code pro Sprachversion konsistent über alle Ausgabekanäle hinweg verwenden, niemals Sprach- und Regionscode vertauschen oder Groß- und Kleinschreibung uneinheitlich handhaben.
7. Häufiger Fehler 3: Konflikte mit Canonical und nicht-indexierbare Ziel-URLs
hreflang und canonical verfolgen unterschiedliche Zwecke und dürfen nicht vermischt werden: Der canonical-Tag einer Seite muss immer auf sich selbst zeigen, ein sogenanntes Self-Referencing Canonical, niemals auf die andere Sprachversion. Zeigt die deutsche Seite per Canonical auf die englische Seite, signalisiert das Google, dass die deutsche Version nicht eigenständig indexiert werden soll, was die gesamte hreflang-Struktur aushebelt, weil eine als nicht kanonisch markierte Seite gar nicht erst als hreflang-Ziel infrage kommt.
Ebenso kritisch: hreflang-Links dürfen niemals auf URLs zeigen, die per noindex ausgeschlossen sind, einen 3xx-Redirect auslösen oder mit 404 antworten. Google ignoriert solche Ziel-URLs komplett und meldet in der Search Console entsprechende Warnungen. Ein häufiger Praxisfall in Magento-Shops: Nach der Deaktivierung eines Store Views bleiben alte hreflang-Verweise auf dessen URLs bestehen, die inzwischen auf die Startseite weiterleiten. Diese toten Referenzen sollten bei jeder Store-View-Änderung systematisch bereinigt werden.
8. Testen und Validieren der hreflang-Implementierung
Die Google Search Console bietet keinen dedizierten hreflang-Bericht mehr wie früher unter „International Targeting", meldet fehlerhafte hreflang-Beziehungen aber weiterhin über den Bericht zur Seitenindexierung sowie über einzelne URL-Prüfungen im URL-Inspection-Tool, das die tatsächlich erkannten hreflang-Ziele einer Seite anzeigt. Für eine vollständige Übersicht über alle hreflang-Paare eines Shops sind Drittanbieter-Tools wie Screaming Frog mit aktivierter hreflang-Prüfung oder Sitebulb deutlich praktikabler, da sie automatisch alle fehlenden Rückverlinkungen und inkonsistenten Codes in einer Crawl-Übersicht auflisten.
Für punktuelle, manuelle Prüfungen genügt oft ein einfacher curl-Befehl gegen den HTML-Head beider Seiten, um zu verifizieren, dass die Rückverlinkung tatsächlich live ist und nicht nur lokal getestet wurde. Wichtig ist, jede hreflang-Prüfung nach jedem Deployment zu wiederholen, da bereits kleine Layout- oder Template-Änderungen versehentlich hreflang-Tags aus dem Head entfernen können, ohne dass dies optisch auffällt. Eine automatisierte Prüfung als Teil der CI/CD-Pipeline verhindert, dass solche Regressionen unbemerkt live gehen.
#!/usr/bin/env bash
# Verify that DE and EN pages reciprocally reference each other via hreflang
DE_URL="https://mironsoft.de/blog/seo-hreflang-korrekt-einsetzen"
EN_URL="https://mironsoft.de/blog/seo-implementing-hreflang-correctly"
echo "Checking hreflang tags on DE page..."
curl -s "$DE_URL" | grep -o '<link rel="alternate" hreflang="[^"]*" href="[^"]*"'
echo "Checking hreflang tags on EN page..."
curl -s "$EN_URL" | grep -o '<link rel="alternate" hreflang="[^"]*" href="[^"]*"'
# Confirm the DE page's hreflang="en" value matches EN_URL exactly
curl -s "$DE_URL" | grep -q "hreflang=\"en\" href=\"$EN_URL\"" \
&& echo "OK: DE page correctly links to EN_URL" \
|| echo "FAIL: DE page is missing or has a wrong hreflang=en link"
# Confirm the EN page's hreflang="de" value matches DE_URL exactly
curl -s "$EN_URL" | grep -q "hreflang=\"de\" href=\"$DE_URL\"" \
&& echo "OK: EN page correctly links back to DE_URL" \
|| echo "FAIL: EN page is missing or has a wrong hreflang=de link"
9. Praxisbeispiel: hreflang im mironsoft.de DE/EN-Blog
Dieser Artikel selbst ist ein praktisches Beispiel für korrekt implementiertes hreflang: Die deutsche Version unter /blog/seo-hreflang-korrekt-einsetzen und die englische Version unter /blog/seo-implementing-hreflang-correctly verweisen im HTML-Head reziprok aufeinander. Jede Seite trägt sowohl einen hreflang="de"- als auch einen hreflang="en"-Link, deren href-Werte exakt auf die jeweils andere URL zeigen. Beide Seiten haben zusätzlich einen Self-Referencing Canonical, der ausschließlich auf die eigene URL verweist, nie auf die Übersetzung.
Strukturell sind beide Sprachversionen bewusst identisch aufgebaut: gleiche Anzahl an Abschnitten, gleiche Code-Beispiele, gleiche FAQ-Anzahl, nur der Text ist übersetzt. Diese Konsistenz ist kein Zufall, sondern eine bewusste SEO-Entscheidung: Google kann Sprachpaare zuverlässiger als tatsächliche Übersetzungen desselben Inhalts erkennen, wenn Struktur und Umfang übereinstimmen, statt wenn die englische Version nur eine gekürzte Zusammenfassung der deutschen ist. Für ein wachsendes Blog-Archiv mit mehreren Dutzend Artikelpaaren ist eine dynamische, ViewModel-basierte Generierung der hreflang-Tags pro Store View der einzig praktikable Weg, diese Reziprozität dauerhaft ohne manuelle Pflege sicherzustellen.
<?php
declare(strict_types=1);
namespace Mironsoft\SeoSuite\ViewModel;
use Magento\Framework\View\Element\Block\ArgumentInterface;
use Magento\Store\Api\Data\StoreInterface;
use Magento\Store\Model\StoreManagerInterface;
/**
* ViewModel that generates reciprocal hreflang link tags for every active store view.
*/
class HreflangViewModel implements ArgumentInterface
{
/**
* @param StoreManagerInterface $storeManager Store manager used to resolve all active store views.
*/
public function __construct(
private readonly StoreManagerInterface $storeManager
) {
}
/**
* Builds a map of hreflang code to absolute URL for the current page across all store views.
*
* @param string $currentPath Relative request path shared by all language variants, e.g. "blog/example".
* @return array<string, string> Map of hreflang code (e.g. "de", "en", "x-default") to absolute URL.
* @throws \Magento\Framework\Exception\NoSuchEntityException
*/
public function getHreflangLinks(string $currentPath): array
{
$links = [];
/** @var StoreInterface[] $stores */
$stores = $this->storeManager->getStores();
foreach ($stores as $store) {
$hreflangCode = (string) $store->getConfig('general/locale/hreflang_code');
if ($hreflangCode === '') {
continue;
}
// @phpstan-ignore-next-line StoreInterface::getBaseUrl() exists on the Store model
$links[$hreflangCode] = rtrim($store->getBaseUrl(), '/') . '/' . ltrim($currentPath, '/');
}
if (isset($links['de'])) {
$links['x-default'] = $links['de'];
}
return $links;
}
}
Die folgende Übersicht fasst die in diesem Artikel behandelten hreflang-Fehler zusammen und zeigt jeweils Symptom, Ursache und die korrekte Lösung.
| Fehler | Symptom | Warum es passiert | Korrekte Lösung |
|---|---|---|---|
| Fehlende Rückverlinkung | hreflang-Beziehung wird von Google ignoriert | URL-Änderung ohne Anpassung der Schwesterseite | Beide Seiten bestätigen sich gegenseitig per hreflang |
| Falscher Sprach-/Regionscode | hreflang-Tag wird nicht erkannt oder falsch zugeordnet | Ländercode statt Sprachcode, falsche Groß-/Kleinschreibung | ISO 639-1 klein + ISO 3166-1 groß, z. B. en-GB |
| hreflang/Canonical-Konflikt | Zielseite wird nicht indexiert, hreflang wirkungslos | Canonical zeigt auf andere Sprachversion statt auf sich selbst | Self-Referencing Canonical auf jeder Sprachversion |
| Fehlendes x-default | Falsche Sprachversion für nicht abgedeckte Regionen | x-default vergessen oder als normale Sprache behandelt | x-default auf Sprachauswahl oder neutralste Variante |
| hreflang zeigt auf Redirect/404 | Google ignoriert das hreflang-Ziel komplett | Store View deaktiviert, URL nicht bereinigt | hreflang-Verweise bei jeder Store-View-Änderung aktualisieren |
In der Praxis verstärken sich diese Fehler oft gegenseitig: Eine fehlende Rückverlinkung fällt häufig erst auf, wenn parallel auch ein Sprachcode falsch gesetzt wurde, weil beide Fehler im Search-Console-Bericht ähnlich aussehen. Wer hreflang von Anfang an dynamisch pro Store View generiert und automatisiert testet, vermeidet die meisten dieser Fehlerquellen von vornherein, statt sie nachträglich manuell zu korrigieren.
Mironsoft
Internationales SEO, hreflang-Audits und Multi-Store-View-Setup für Magento-Shops
hreflang professionell implementieren lassen?
Wir analysieren die hreflang-Struktur eures Magento-Shops, identifizieren fehlende Rückverlinkungen und Code-Fehler und implementieren eine dynamische, wartungsfreie Lösung für alle Store Views.
hreflang-Audit
Vollständige Prüfung aller Sprachpaare auf Reziprozität und korrekte Codes
Internationale SEO-Beratung
Strategie für x-default, Zielgruppen und Store-View-Struktur
Multi-Store-View-Setup
Dynamische hreflang-Generierung direkt im Magento ViewModel
10. Zusammenfassung
hreflang korrekt einsetzen löst ein Kernproblem mehrsprachiger Websites: Google muss zuverlässig erkennen können, welche Sprachversion welchem Nutzer gezeigt werden soll, ohne die Varianten als konkurrierenden Duplicate Content zu behandeln. Die Syntax selbst ist einfach, ISO-639-1-Sprachcode plus optionaler ISO-3166-1-Regionscode, doch die eigentliche Herausforderung liegt in der konsequenten Rückverlinkung: Jede hreflang-Angabe muss von der Zielseite reziprok bestätigt werden, sonst wird sie von Google vollständig ignoriert.
Die häufigsten Fehler, fehlende Rückverlinkung, falsche Sprachcodes und Konflikte mit dem Canonical-Tag, lassen sich mit automatisierten Tests und regelmäßigen Crawls zuverlässig verhindern. Für Magento-Shops mit mehreren Store Views ist eine dynamische, code-generierte Lösung wie ein ViewModel der einzig robuste Ansatz, da manuelle Pflege bei wachsender Sprachanzahl schnell fehleranfällig wird. Dieser Artikel selbst demonstriert die korrekte Umsetzung anhand seiner eigenen deutschen und englischen Version.
hreflang korrekt einsetzen, das Wichtigste auf einen Blick
Syntax korrekt
ISO 639-1 Sprachcode plus optionaler ISO 3166-1 Regionscode. Platzierung im Head, HTTP-Header oder in der Sitemap.
Rückverlinkung
Jede hreflang-Angabe muss reziprok von der Zielseite bestätigt werden, sonst wird sie von Google ignoriert.
x-default
Fallback für nicht abgedeckte Sprachen und Regionen, zeigt auf Sprachauswahl oder neutralste Variante.
Testen & Validieren
Search-Console-URL-Inspection, Screaming Frog und curl-Checks nach jedem Deployment.