Nachdem du eine Staging-Seite auf die Produktion gepusht hast, kann Yoast SEO die Staging-Domain als Canonical URL beibehalten — oder den Canonical ganz weglassen. Die Lösung besteht darin, die Indexables von Yoast neu aufzubauen, sodass jeder Canonical gegen deine Live-Domain neu generiert wird, und den Canonical für jede einzelne Seite, die noch falsch ist, manuell zu setzen.
Warum sind Yoast Canonical URLs nach einer Website-Migration falsch?
Yoast SEO berechnet Canonical URLs nicht bei jedem Seitenaufruf. Es speichert sie in seinen Indexables — einem Cache von SEO-Daten, der in der Datenbanktabelle wp_yoast_indexable gehalten wird, plus Werte pro Beitrag in wp_postmeta. Wenn du eine Staging-Seite auf deine Produktionsseite pushst, wandern diese Zeilen mit der Datenbank.
Wenn die Indexables aufgebaut wurden, während die Seite noch die Staging-Domain verwendet hat, enthalten sie Staging-URLs. Nach dem Push siehst du eines von zwei Symptomen:
- Das
rel="canonical"-Tag zeigt auf die Staging-URL (zum Beispielhttps://staging.example.com/page/statthttps://example.com/page/). - Das Canonical-Tag fehlt bei einigen Seiten, weil die gespeicherte Indexable-Zeile veraltet oder unvollständig ist.
Die Ursache sind die zwischengespeicherten Indexable-Daten, nicht eine kaputte Yoast-Installation. Yoast gibt für jeden öffentlichen Beitrag und jede Seite automatisch einen selbstreferenzierenden Canonical aus — es gibt keinen globalen Ein-/Aus-Schalter zum Umlegen. Das Ziel ist also, Yoast dazu zu bringen, diesen Cache gegen die korrekte Domain neu aufzubauen.
Wie behebe ich die Canonical URL einer einzelnen Seite in Yoast SEO?
Wenn nur eine oder wenige Seiten betroffen sind, überschreibe den Canonical direkt im Editor:
- Öffne die betroffene Seite oder den betroffenen Beitrag im WordPress-Editor.
- Öffne in der Yoast SEO-Seitenleiste (oder der Yoast-Meta-Box unter dem Inhalt) den Tab Erweitert.
- Suche das Feld Canonical URL.
- Gib die korrekte Live-URL ein — oder leere das Feld, damit Yoast auf seinen standardmäßigen selbstreferenzierenden Canonical gegen deine Live-Domain zurückfällt.
- Aktualisiere die Seite.
Das Feld leer zu lassen ist meist die richtige Wahl: Ein selbstreferenzierender Canonical ist das, was die meisten Seiten haben sollten. Gib nur dann eine explizite URL ein, wenn die Seite auf einen anderen Canonical zeigen soll (zum Beispiel eine syndizierte oder duplizierte Seite).
Wie behebe ich Canonical URLs nach einer vollständigen Website-Migration im Stapel?
Wenn viele Seiten die Staging-Domain tragen, ist es unpraktisch, sie einzeln zu beheben. Baue stattdessen alle Indexables auf einmal neu auf.
Option 1: Yoasts SEO-Daten zurücksetzen und neu optimieren
- Installiere und aktiviere das Yoast Test Helper Plugin.
- Gehe zu Werkzeuge → Yoast Test.
- Klicke auf Reset Indexables & Migrations. Dies löscht die zwischengespeicherten Indexables, sodass Yoast sie von Grund auf neu aufbaut.
- Gehe zu SEO → Werkzeuge und klicke auf Start SEO data optimization. Yoast generiert jedes Indexable — einschließlich Canonical URLs — gegen deine aktuelle (Live-)Domain neu.
- Deaktiviere das Yoast Test Helper Plugin, sobald die Optimierung abgeschlossen ist; es ist ein Entwicklerwerkzeug und nicht dazu gedacht, aktiv zu bleiben.
Option 2: Indexables mit WP-CLI neu aufbauen
Wenn du Shell-Zugriff hast, läuft derselbe Neuaufbau über die Kommandozeile:
wp yoast indexDies reindexiert alle Indexables von Yoast für die aktuelle Seite. Es ist auf großen Seiten schneller als der browserbasierte Optimizer und kann gefahrlos erneut ausgeführt werden.
Nach jeder der beiden Optionen leere jeden Cache — dein Caching-Plugin, den Server-Cache und das CDN — sodass Besucher und Crawler die korrigierten Canonical-Tags erhalten statt einer zwischengespeicherten Kopie der alten.
Noch eine Sache zum Überprüfen: Bestätige, dass beim Push ein Suchen-und-Ersetzen auf der Datenbank gelaufen ist, das die Staging-Domain gegen die Live-Domain ausgetauscht hat. WP STAGING macht das beim Pushen automatisch, aber wenn du die Datenbank auf andere Weise importiert hast, ist eine übrig gebliebene Staging-Domain in den Daten die eigentliche Ursache, die der Neuaufbau der Indexables allein nicht behebt.
Wie verhindere ich Canonical-URL-Probleme beim nächsten Push?
- Lass WP STAGING das Domain-Rewrite übernehmen. Wenn du mit WP STAGING pushst, führt es ein Suchen-und-Ersetzen über die gesamte Datenbank durch, einschließlich der Daten von Yoast. Vermeide manuelle Datenbankimporte, die diesen Schritt überspringen.
- Baue die Indexables nach jedem Push neu auf. Mache "Reset Indexables & Migrations + SEO data optimization" (oder
wp yoast index) zu einem Teil deiner Checkliste nach dem Push. - Codiere niemals einen Canonical pro Seite fest auf die Staging-Domain. Wenn du beim Testen auf Staging einen expliziten Canonical gesetzt hast, leere ihn vor dem Push, damit die Live-Seite auf einen selbstreferenzierenden Canonical zurückfällt.
Hintergründe dazu, warum Canonical-Tags wichtig sind, findest du in Googles Leitfaden zum Konsolidieren doppelter URLs und in Yoasts Erklärung zu rel="canonical".
Häufig gestellte Fragen
Löscht das Zurücksetzen der Yoast-Indexables meine SEO-Einstellungen?
Nein. Das Zurücksetzen der Indexables löscht nur die zwischengespeicherten SEO-Daten. Yoast baut sie aus deinen bestehenden Beiträgen und Einstellungen neu auf, sodass deine Titel, Meta-Beschreibungen, Fokus-Keywords und Konfiguration unverändert bleiben.
Warum ist meine Canonical URL nach einer Migration leer?
Ein fehlender Canonical bedeutet fast immer, dass die Indexable-Zeile der Seite veraltet ist oder nicht gegen die neue Domain neu generiert wurde. Der Neuaufbau der Indexables (Option 1 oder 2 oben) stellt den selbstreferenzierenden Canonical wieder her.
Brauche ich das Yoast Test Helper Plugin, um das zu beheben?
Es ist der einfachste Weg, Indexables und Migrationen aus dem WordPress-Adminbereich zurückzusetzen. Wenn du die Kommandozeile bevorzugst, erledigt wp yoast index den Neuaufbau ohne zusätzliches Plugin. So oder so ist das Ziel dasselbe: Yoast zu zwingen, seine zwischengespeicherten SEO-Daten neu zu generieren.
Gilt das sowohl für Yoast SEO Free als auch für Premium?
Ja. Indexables existieren sowohl in der kostenlosen als auch in der Premium-Version von Yoast SEO, daher behebt derselbe Reset-und-Neuaufbau-Prozess Canonical URLs in beiden.
