Die Idee zum Shopware Redirect Plugin
Mit dem Shopware Redirect Plugin wollen wir von scope01 eine große Arbeitserleichterung und Hilfe schaffen. Denn immer wieder stehen wir als E-Commerce Agentur vor der mühsamen Herausforderung, dass wir für Kunden redirects (Weiterleitungen, bzw. Umleitungen) z.B. bei einem Livegang oder bei Änderungen / Deaktivierung von Produkten in der htaccess manuell verwalten müssen.
Dies ist für den Kunden weder nachvollziehbar noch im laufenden Betrieb administrierbar. Denn in Regel arbeitet kein Kunde an einer htaccess Datei. Auch ist die Abstimmung über den Versand von Excel / CSV Daten ziemlich umständlich und zeitaufwändig. So kamen wir auf die Idee für Shopware ein Plugin zu entwickeln, in welchem die User redirects im Shopware Backend verwalten können. Zuerst haben wir das Plugin für Shopware 5 entwickelt, dann auch für Shopware 6.
Was sind Weiterleitungen?
2 Arten von Weiterleitungen sind für die Administration von Onlineshops sehr wichtig:
- Der Statuscode 301 steht für eine dauerhafte Umleitung (moved permanently). Diese kommt zum Beispiel dann zum Einsatz, wenn ein Artikel ausverkauft und bereits ein Nachfolger definiert ist. Auf diesen Nachfolger soll dann automatisch verlinkt werden.
- Der Statuscode 302 steht für eine vorübergehende Umleitung (moved temporarily). Zum Beispiel ein Artikel hat keinen Bestand mehr und soll für eine bestimme Zeit offline genommen werden. So können Sie im Shop vorübergehend auf ein alternatives Produkt weiterleiten.
Durch den Eintrag von Weiterleitungen werden Fehler (z.B. Fehler 404 nicht gefunden) für den Besucher des Onlineshops vermieden. Zusätzlich wird der Wert einer suchmaschinenoptimierten Seite von dem alten auf den neuen Artikel übertragen.
Shopware 6
Seit 2020 bieten wir unser erfolgreiches Shopware Redirect Plugin für die Version 6 von Shopware an. Dieses ist von uns grundlegend neu entwickelt worden, da sich die technische Basis von Shopware Version 5 zu Version 6 komplett verändert hat. Damit stehen auch in der neuen Version der E-Commerce Software die Möglichkeiten zur Einrichtung von Weiterleitungen zur Verfügung. Sowohl für dauerhafte (301) als auch temporäre Weiterleitungen (302). Dieses Plugin können Sie hier im Shopware Store herunterladen.
Die Administration der Weiterleitungen befindet sich in Shopware 6 unter Einstellungen – Shop – Weiterleitungen:
Administration im Shopware Redirect Plugin
Die Administration bündelt alle Funktionen für 301- und 302-Weiterleitungen zentral im Shopware Backend.
Premium Funktionen über In-App-Käufe
Ab der Shopware Version 6.7 bieten wir zusätzliche Premium-Features an, die direkt innerhalb des Plugins über das Shopware In-App-Kauf-System erworben werden können. Um ein Feature zu kaufen, navigieren Sie in der Administration zu Erweiterungen > Meine Erweiterungen > SEO Redirect > Konfigurieren. Dort finden Sie eine Übersicht der verfügbaren Erweiterungen:
- Automatische Weiterleitungen: Erstellt beim Deaktivieren von Produkten automatisch einen Redirect, um Ranking-Verluste zu vermeiden.
- Suchfunktion: Ermöglicht das schnelle Durchsuchen Ihrer angelegten Weiterleitungen direkt im Listing.
- 404-Log: Das mächtige Tool zur Identifizierung und Behebung von Fehlern im Storefront.
Der 404-Log (Premium Feature)
Der 404-Log macht nicht gefundene URLs sichtbar und zeigt, welche Fehler für Besucher und Suchmaschinen tatsächlich relevant sind.
Häufige Fragen Shopware Redirect Plugin (FAQ)
Fragen zur Funktion des Plugins
Um unser Plugin zu nutzen, müssen die alten URLs weiterhin erreichbar sein. Da dies in der Regel nicht der Fall ist, eignet sich eine Konfiguration der Weiterleitungen mittels eines einzelnen .htaccess Befehls eher. Sonst müssen Sie auch jede einzelne URL mit Quelle und Ziel in unserem Redirect Plugin hinterlegen, um das gewünschte Verhalten zu erreichen.
Ja. Dabei ist es egal, ob die verschiedenen Sales Channel über unterschiedliche Domains erreicht werden oder über die selbe Domain.
Ja. Seit der Version 1.2.0 ist es möglich, Query Strings in der Quell URL zu ignorieren. Dies kann für jede Weiterleitung individuell aktiviert/deaktiviert werden. Seit der Version 2.1.0 ist es außerdem möglich, Query Strings aus der aufgerufenen ULR in die Ziel URL zu übernehmen.
Ja. Seit der Version 2.2.0 unterstützt das Plugin spezielle Zeichen wie Umlaute in der Quell-URL. Diese Unterstützung muss in der Plugin Konfiguration aktiviert werden.
Mit dem Redirect Plugin lassen sich nur Weiterleitungen realisieren, deren Quell URLs sich in der Shopware Umgebung befinden. Die Ziel URLs können frei gewählt werden und müssen sich nicht in der Shopware Umgebung befinden.
Das Redirect Plugin ergänzt die Shopware Logiken bezüglich Weiterleitungen.
Die von Shopware gesetzten Weiterleitungen werden im Redirect Plugin nicht aufgeführt.
Nein. Ist eine Weiterleitung keinem Verkaufskanal zugewiesen, ist diese in allen Verkaufskanälen aktiv.
Fragen zu Premium-Funktionen
Die Premium-Funktionen des SEO Redirect Plugins werden über das Shopware In-App-Kauf-System bereitgestellt. Voraussetzung dafür ist mindestens Shopware 6.7.4 und mindestens die Plugin Version 4.1.3.
Die Suche befindet sich oberhalb der Weiterleitungsliste und nutzt die normale Suchleiste der Shopware Administration. Geben Sie dort Ihren Suchbegriff ein, um bestehende Weiterleitungen zu finden. Voraussetzung sind eine kompatible Plugin-Version unter Shopware 6.7 und ein aktiviertes Premium-Abonnement.
Die automatische Weiterleitung muss in der Plugin-Konfiguration aktiviert werden. Sie berücksichtigt sowohl Produkte als auch Varianten:
- Deaktivierte Produkte: Beim Deaktivieren wird automatisch eine 302-Weiterleitung von der bisherigen SEO-URL auf die Startseite angelegt. Wird das Produkt wieder aktiviert, entfernt das Plugin diese automatische Weiterleitung. Ein Leeren des Caches ist dafür nicht erforderlich.
- Gelöschte Produkte: Beim Löschen wird eine Weiterleitung von der letzten SEO-URL auf die Startseite erstellt. Der Statuscode 301 oder 302 ist konfigurierbar. Diese Weiterleitung bleibt bestehen – auch wenn später ein Produkt mit derselben Artikelnummer neu angelegt wird.
Nein. Die Automatik reagiert auf Deaktivierungen und Löschungen, die nach der Freischaltung und Aktivierung der jeweiligen Premium-Funktion stattfinden. Für bereits zuvor deaktivierte Produkte und Varianten werden keine Weiterleitungen nachträglich erzeugt. Solche Altfälle müssen bei Bedarf manuell oder über den Import angelegt werden.
Nein. Die automatische Weiterleitung berücksichtigt zwar auch Varianten, verwendet als Ziel jedoch die Startseite. Eine automatische Zuordnung einer Variante zum jeweiligen Hauptartikel wird derzeit nicht unterstützt. Wenn Sie eine Variante auf einen bestimmten Hauptartikel umleiten möchten, müssen Sie dafür eine entsprechende Weiterleitung anlegen.
In der Plugin-Konfiguration können Sie die automatische Bereinigung aktivieren und eine Aufbewahrungsdauer in Tagen festlegen. Die Bereinigung erfolgt regelmäßig über einen Shopware Scheduled Task. Maßgeblich ist der letzte Aufruf der jeweiligen Fehler-URL. Ignorierte Einträge und Einträge, die bereits mit einer Weiterleitung verknüpft sind, bleiben erhalten.
Über „URL-Muster ignorieren“ können Sie außerdem bestimmte URLs von der Erfassung ausschließen. Tragen Sie dafür pro Zeile ein Glob-Muster ein. Passende URLs werden anschließend weder protokolliert noch als 404-Aufrufe gezählt.
Diese Muster dienen ausschließlich der Filterung des 404-Logs. Sie ermöglichen keine Wildcard-Weiterleitungen.
Prüfen Sie zunächst, ob der Kauf im Shopware Account für den richtigen Shop hinterlegt ist. Bei einem Testsystem sollten Sie zusätzlich kontrollieren, ob die Staging-Domain korrekt registriert und dem entsprechenden Shop zugeordnet ist.
Melden Sie sich anschließend in der Administration vom Shopware Account ab und erneut an. Auch das Leeren des Browser-Caches kann helfen.
Fragen zur Bedienung des Plugins
In Shopware 6 unter Einstellungen – Shop – Weiterleitungen.
Am besten einmalig im Plugin Weiterleitungen anlegen und diese dann exportieren. Diese Datei dann bitte als Vorlage verwenden. Denn oftmals gibt es beim Import Probleme mit der Kodierung (Zeichensatz), den Spaltennamen, evtl. Leerzeichen uvm. Als Trennzeichen muss ein Semikolon (;) verwendet werden.
Grundsätzlich kann es beim Importieren vorkommen, dass eine Weiterleitung in der Import Datei bereits im System vorhanden ist. Für diesen Fall können Sie festlegen, ob das System die vorhandene Weiterleitung im System mit der Weiterleitung aus der Datei überschreiben soll, oder ob die Weiterleitung in der Datei übersprungen werden soll.
Dabei gibt es 2 Möglichkeiten, gleiche Weiterleitungen zu erkennen – für beide Möglichkeiten können Sie separat zwischen überschreiben und überspringen wählen:
- Die IDs der Weiterleitungen sind gleich
- Die Quell URLs der Weiterleitungen sind gleich
Für jede Weiterleitung kann individuell entschieden werden, wie mit Query Parametern umgegangen wird. Dabei stehen folgende Optionen zur Auswahl:
- „Query Parameter bei der Suche berücksichtigen“: Bei der Suche nach einer passenden Weiterleitung wird nach der aufgerufenen URL inklusive Query Parameter gesucht.
- „Query Parameter bei der Suche ignorieren“: Bei der Suche nach einer passenden Weiterleitung wird nach der aufgerufenen URL mit und ohne Query Parameter gesucht.
- „Query Parameter bei der Suche ignorieren und zur Ziel-URL hinzufügen“: Die Parameter werden an die konfigurierte Ziel-URL angehängt.
Damit eine neue Weiterleitung erzeugt wird, muss das Feld in der Spalte „id“ einfach leer gelassen werden.
Technische Fragen
Die Tabelle heißt scop_platform_redirecter_redirect.
Den QuellCode können Sie bei Github einsehen
Prüfen Sie zunächst, ob die Weiterleitung aktiviert ist, zum aufgerufenen Verkaufskanal passt und die Einstellungen für Query-Parameter stimmen. Quell- und Ziel-URL dürfen keine Schleife bilden – beispielsweise durch eine weitere Regel, die vom Ziel wieder zur Quelle zurückführt.
Berücksichtigen Sie außerdem Weiterleitungen außerhalb des Plugins, etwa in der .htaccess, der Webserver-Konfiguration oder für Sprachpfade und www-/Non-www-Domains. Diese Regeln können mit den Plugin-Weiterleitungen kollidieren.
Major Updates Shopware Redirect Plugin
Im Mai 2026 haben wir eine weitere Premium Funktion für die „In-App-Käufe“ umgesetzt: Das 404-Log. Es werden nun alle URLs gelistet, welche auf einen 404 Fehler laufen, diese können nun direkt analysiert, in Weiterleitungen umgewandelt oder ignoriert werden. (Premium-Funktion)
Im April 2026 haben wir eine weitere Premium Funktion für die „In-App-Käufe“ umgesetzt: Die automatische Erstellung von Weiterleitungen beim Deaktivieren von Produkten hinzugefügt. (Premium-Funktion)
Im November 2025 haben wir das 1. Feature für die In-App Käufe umgesetzt, die Suchfunktion im Redirect Plugin. Die In-App Käufe bei Shopware gibt es erst ab der Shopware Version 6.7
Im April 2025 haben wir die Kompatibilität zu Shopware 6.7 hergestellt und im Store veröffentlicht
Im Oktober 2024 haben wir bei dem Shopware Redirect Plugin eine Umstellung der Im- und Exportfunktion vorgenommen. Diese wurde auf den Shopware Standard umgebaut.
Im Februar 2024 haben wir für das Shopware Redirect Plugin die Kompatibilität mit Shopware 6.6 hergestellt sowie Paging-Probleme behoben.
Im Admin von Shopware wurde in der Übersicht der Verkaufskanal hinzugefügt.
Unterstützung für spezielle Zeichen (wie Umlaute) in der Quell-URL hinzugefügt sowie Fehlerbehebung bei leeren URLs.
Integration der Import- und Exportfunktion für Shopware 6 via CSV sowie Aktivierung/Deaktivierung einzelner Weiterleitungen.
Refactoring auf Version 1.0.6: Grundlegende Code-Optimierung, PHP-Unit Tests hinzugefügt und Plugin-Kompatibilität angepasst.
Fragen zum Shopware Redirect Plugin
Bei Fragen zum Shopware Redirect Plugin oder zu Shopware wenden Sie sich bitte direkt an uns. Als zertifizierter und prämierter Shopware Partner stehen wir Ihnen gerne zur Verfügung.
Shopware Referenzen
Shopware News
Shopware AI Copilot: Der intelligente Assistent für Ihren Onlineshop
Pflicht des Widerrufsbuttons in Onlineshops ab 19.06.2026

