Ein besseres Hilfedokument
Geschrieben und gepflegt für die Marken und Agenturen, die gerade eine Website-Migration durchführen. Besonders dann, wenn Sie ein kleines Team sind, bei dem jede Stunde zählen muss. Dieser Leitfaden hilft Ihnen dabei, eine Strategie zu bauen, mit der Sie 301-Weiterleitungen präzise umsetzen, wenn Sie zu Shopify migrieren. Konkret hilft Ihnen dieses Dokument, wenn Sie:
- Von Wordpress migrieren
- Von Magento migrieren
- Von Salesforce migrieren
- Von Sitecore migrieren
- Von BigCommerce migrieren
- Von Webflow migrieren
- Von einer selbst gebauten PHP-Website migrieren
Wenn Sie ein Projekt mit komplexen 301-Weiterleitungszuordnungen angehen und ein Team brauchen, das genau diese Art von Arbeit lebt, sprechen Sie uns an.
Die Logik der URL-Weiterleitungen bei Shopify: Überblick
Das offizielle Hilfedokument von Shopify zu URL-Weiterleitungen finden Sie hier. Es ist ein schlankes Dokument mit allgemeinen Hinweisen, an denen sich Shop-Verantwortliche beim Anlegen einzelner und massenhafter 301-Weiterleitungen orientieren können. Konkrete Angaben dazu, welche URL-Typen ein Shopify-Shop nativ unterstützt, fehlen darin, und dieser Bericht soll diese Lücken füllen.
Die Befunde zur URL-Weiterleitungsfunktion von Shopify in Kürze
- Die Logik der URL-Weiterleitungen bei Shopify ist sehr robust.
- In unserem Test mit 100 verschiedenen URL-String-Formaten unterstützte Shopify 99 der 100 Typen funktional.
- Das native System unterstützt keine Wildcards für URL-Weiterleitungen.
- Bestehende Weiterleitungspfade ließen sich mit dem Importwerkzeug leicht aktualisieren, solange man den undokumentierten Regeln von Shopify folgt.
- Für die Gesamtzahl der Weiterleitungen, die Shopify- und ShopifyPlus-Shops verwalten, gelten Grenzen.
- Für die Gesamtzahl der Zeichen eines Weiterleitungs-Strings gelten Grenzen.
- Sie können zum Glück keine 301-Weiterleitungsketten anlegen. (Im Nachtest 2026 korrigiert. Die Sicherung prüft nur eine Richtung.)
- Für URLs mit Parametern gelten viele Ausnahmen und Regeln.
- Die Oberfläche für die Verwaltung der Weiterleitungen ist benutzerfreundlich, könnte aber mehr Details vertragen.
- Die Tests haben die Weiterleitungsoptionen von Hydrogen und Oxygen nicht untersucht.
- Wir geben dem aktuellen System für URL-Weiterleitungen von Shopify einen Nützlichkeitswert von 85 %.
Der Wert wurde um 5 % gesenkt, weil Wildcards nicht unterstützt werden, um 1 % wegen des einen nicht unterstützten URL-String-Typs, um 2 % wegen der Zeichenlängengrenzen, um 3 % wegen des eigenwilligen Verhaltens bei parametrisierten URLs und um 4 % wegen wesentlicher Angaben zur Datenverwaltung, die in der Weiterleitungs-UX fehlen.
Die Tests wurden am 19. Juni 2024 durchgeführt.
Jede Aussage hier wurde gegen einen echten Shopify-Shop im Standardtarif erneut geprüft, über die Admin GraphQL API und gegen echte Storefront-Requests. Die meisten Befunde von 2024 hielten stand. Neun nicht, und zwei davon kehren um, was wir veröffentlicht hatten: Die Kettensicherung prüft nur eine einzige Richtung und die Reihenfolge, in der Sie Datensätze anlegen, entscheidet über die Entstehung einer Kette, und eine Weiterleitung auf /services greift, während alles darunter einen 404 liefert.
Die Befunde von 2024 bleiben, wo sie sind. Jede Korrektur ist bei der Aussage vermerkt, für die sie gilt, damit alle, die nach der ursprünglichen Fassung gehandelt haben, sehen, was sich verschoben hat.
Unsere Methodik beim Testen der Weiterleitungen
Wir wollten mit unseren Tests einige Fragen beantworten, um Fallstricke bei den 301-Weiterleitungsregeln von Shopify zu vermeiden:
- Welche Zeichen oder String-Kombinationen unterstützt das System für URL-Weiterleitungen nicht?
- Gibt es Grenzen bei der Länge eines URL-Strings?
- Gibt es eine Höchstzahl an Datensätzen für Massenimporte?
- Unterstützt das System Wildcard-Weiterleitungen?
- Gibt es nach dem Import eine automatische Formatierung oder Umwandlung von Strings, die die ursprünglichen Daten verändert?
Zum Nachschlagen finden Sie hier unsere vollständige URL-Liste, mit der wir diese verschiedenen Bedingungen getestet haben. Die Tests liefen in einem Shopify-Standardtarif, nicht in ShopifyPlus.
11 Befunde, die bei Shopify-Weiterleitungen helfen
Mit diesen URL-String-Typen kommt Shopify nicht zurecht
Die Liste der URL-String-Formate, die Shopify nicht unterstützen konnte, ist kurz: Es gab nur einen String-Typ, den das System nicht übernehmen konnte. Strings mit einem Semikolon nach dem Gleichheitszeichen, etwa:
/page?param=;semicolon
Bemerkenswert an diesem String ist, dass das System von Shopify das Sonderzeichen Semikolon in der Weiterleitungstabelle in den URL-kodierten Wert umwandelt:
/page?param=%3Bsemicolon
Wenn Sie den nicht kodierten URL-String in die Adresszeile eines Browsers eingeben, kommt ein 404-Fehler zurück.
/page?param=;semicolon
/page?param=%3Bsemicolon
Dieses Verhalten weicht vom Umgang mit anderen Sonderzeichen ab. Wenn ein URL-String mit nicht kodierten Zeichen in die Adresszeile eingegeben wird, etwa mit der geschweiften Klammer rechts:
/page?param=}
kodiert Shopify sie beim Eingang des Requests automatisch, und es kommt kein 404-Fehler.
/page%7Drightbrace
Ebenfalls bemerkenswert: Andere Varianten eines URL-Strings mit einem nicht kodierten Semikolon werden im Weiterleitungssystem von Shopify akzeptiert, zum Beispiel:
/page;semicolon
Die Daten deuten darauf hin, dass der 404-Fehler nur dann ausgelöst wird, wenn ein nicht kodiertes Semikolon nach dem Gleichheitszeichen steht.
Der 404 ist bestätigt, aber von einem gescheiterten Import kann keine Rede sein. Shopify nimmt den Datensatz an und speichert ihn mit prozentkodiertem Semikolon als %3b. Die Abweichung entsteht beim Request, denn eine eingehende URL mit einem rohen Semikolon trifft nie auf den kodierten Datensatz.
Ein Request auf die kodierte Form liefert wie gewohnt einen 301. Wo Sie die eingehenden Links selbst kontrollieren, löst die Prozentkodierung des Semikolons das Problem. Wo das rohe Semikolon aus externen Links kommt, die Sie nicht kontrollieren, lässt sich dieses Format nicht zuverlässig weiterleiten.
Keine Unterstützung für Wildcard-Weiterleitungen bei Shopify
Wildcard-Weiterleitungen stehen weiterhin auf der Wunschliste vieler Shopify-Nutzer. Die Support-Foren sind voll mit Anfragen nach dieser Funktion. Bis heute schweigt Shopify dazu, wo sie auf der Produkt-Roadmap stehen würde.
Vorerst sollten Website-Betreiber, die einen Umzug zu Shopify planen, wissen, dass natives Shopify und ShopifyPlus diese Möglichkeit nicht bieten.
Was sind Wildcard-Weiterleitungen?
Wildcard-Weiterleitungen sind eine Form der URL-Weiterleitung, mit der Sie mehrere URLs, die einem bestimmten Muster entsprechen, auf ein einziges Ziel umleiten. Das ist besonders nützlich beim Umzug einer Website, beim Umbau von Inhalten oder bei der Verwaltung großer Mengen ähnlicher URLs. Statt für jede URL eine eigene Weiterleitung anzulegen, verwenden Sie ein Platzhalterzeichen (meist *), das für eine beliebige Zeichenfolge steht.
Angenommen, Sie strukturieren Ihren Blog um und verschieben alle Beiträge aus dem Verzeichnis /blog/ nach /articles/. Statt für jeden Blogbeitrag eine eigene Weiterleitung anzulegen, können Sie eine Wildcard-Weiterleitung verwenden:
From: /blog/*
To: /articles/*
This wildcard redirect will automatically map:
/blog/post1 to /articles/post1
/blog/post2 to /articles/post2
/blog/post3 to /articles/post3
Das vereinfacht die Weiterleitung und stellt sicher, dass alle URLs unter /blog/ nahtlos an ihren neuen Ort unter /articles/ geleitet werden. Zum Zeitpunkt dieses Artikels bieten Standard-Shops von Shopify und ShopifyPlus diese Fähigkeit ohne App-Unterstützung nicht.
Nach wie vor keine Wildcard-Unterstützung, und der Nachtest hat den Teil gefunden, der echten Traffic kostet. Shopify nimmt Wildcard-Syntax klaglos an. Ein Datensatz, der als /old-blog/* angelegt wird, speichert sich, erscheint in der Weiterleitungstabelle und meldet keinen Fehler. Das Sternchen wird als literales Zeichen gespeichert, die einzige URL, auf die es je passt, ist also eine, die buchstäblich ein Sternchen enthält.
Das ist schlimmer als eine klare Ablehnung, denn nichts weist auf den Fehler hin, bis echter Traffic 404er zurückbekommt. Lösen Sie alle Wildcards in Ihrer Weiterleitungstabelle in explizite Pfade auf, bevor Sie sie importieren.
Shopify tut sein Bestes, um Weiterleitungsketten zu vermeiden
Die Weiterleitungstabelle von Shopify enthält eine praktische Sicherung, die Sie daran hindert, Weiterleitungsketten anzulegen. Wenn Sie eine Weiterleitung auf eine Seite anlegen wollen, die bereits ein Wert im Feld Weiterleiten von ist, bekommen Sie eine Fehlermeldung.
In diesem Test sahen die URL-Datensätze, die wir anlegen wollten, so aus, und das war nicht erlaubt:
/BOTH redirects to /SHORT/SHORT redirects to /homepage
Eine Sicherung existiert, und sie ist enger als von uns beschrieben. Sie prüft eine Richtung, und im Nachtest ist an ihr vorbei eine aktive Kette über zwei Sprünge entstanden.
Shopify weist eine Weiterleitung ab, deren Ziel bereits Quelle einer anderen Weiterleitung ist, mit Target can't redirect to another redirect. Shopify weist eine Weiterleitung auf sich selbst ab, mit Target can't be the same as path, und blockiert direkte Schleifen in beide Richtungen.
Die umgekehrte Richtung prüft Shopify nicht. Legen Sie /a auf /b an, während unter /b nichts existiert, und später /b auf /c, dann werden beide akzeptiert. Shopify prüft den ersten Datensatz nie erneut, und Sie haben jetzt eine aktive Kette:
GET /a
301 to /b
301 to /
final: 200, 2 hopsAllein die Reihenfolge beim Anlegen entscheidet, ob eine Kette entsteht. Massenimporte wenden die Zeilen in der Reihenfolge der Datei an, und Migrationstabellen sind selten so sortiert, dass das vermieden wird. Auf die Sicherung sollten Sie also nicht planen. Ziehen Sie nach jedem großen Import eine Stichprobe Ihrer Weiterleitungen und zählen Sie die Sprünge:
curl -sIL https://yourstore.com/old-path -o /dev/null -w "hops: %{num_redirects}\n"Alles über 1 ist eine Kette.
Was sind Weiterleitungsketten?
Weiterleitungsketten entstehen, wenn eine URL auf eine andere URL weiterleitet, die ihrerseits auf eine weitere URL weiterleitet, sodass eine Abfolge oder Kette von Weiterleitungen entsteht. Das passiert oft ungewollt, wenn über die Zeit mehrere Weiterleitungen ohne ordentliche Pflege angelegt werden.
Weiterleitungsketten sind problematisch, weil sie Ladezeiten verlangsamen, sich negativ auf SEO auswirken und eine schlechte Nutzererfahrung erzeugen. Jede zusätzliche Weiterleitung kostet Zeit, denn der Browser muss jeden Schritt der Kette abarbeiten, bevor er am endgültigen Ziel ankommt.
Wenn Sie zum Beispiel folgende Weiterleitungen eingerichtet haben:
/old-page redirects to /new-page
/new-page redirects to /latest-page
Ruft eine Nutzerin /old-page auf, wird sie zuerst auf /new-page und unmittelbar danach erneut auf /latest-page geleitet. Das Ergebnis ist eine Weiterleitungskette.
Neue Regeln für das Einrichten von Weiterleitungen bei Shopify
Unsere größte Entdeckung in den Tests ist, dass die Dokumentation von Shopify veraltet ist. Laut Shopify werden Ihre Weiterleitungsregeln nicht angelegt, wenn Sie etwas weiterleiten wollen, das mit diesen reservierten Präfixen beginnt:
/apps
/application
/cart
/carts
/orders
/services
/products
/collections
/collections/all
Wir haben festgestellt, dass das nicht stimmt.
/apps/application/carts/orders/services/cart/people
Cart war die Ausnahme. Für sich allein ist der Pfad reserviert, mit einem nachfolgenden Unterverzeichnis funktioniert er.
/cart/products/collections/collections/all
/cart/people/carts/people/products/people/collections/people
/cart/products/collections/collections/all
Die Beobachtungen oben halten stand. Die Erklärung nicht, und die tatsächliche Regel deckt weit mehr ab als eine Liste von vier Präfixen.
Eine echte Storefront-Route schlägt immer eine Weiterleitung. Wo unter einer URL wirklich eine Seite existiert, liefert Shopify die Seite aus und ignoriert die Weiterleitung. Der Datensatz wird angenommen, er steht in Ihrer Weiterleitungstabelle, und er tut nichts. Kein Fehler, keine Warnung.
Das Präfix ist nicht die Variable. Die Existenz einer Route ist es. Eine Weiterleitung auf eine aktive Produkt-URL wurde angenommen und stillschweigend ignoriert, während dasselbe Präfix mit einem Handle, das nicht existiert, einen 301 lieferte:
/products/ai-skillset-package-001 -> 200, the product page
/products/zz20260727 -> 301, the redirect firesBetrachten Sie die Liste oben also als Beispiele und nicht als die Regel. Sie deckt außerdem jedes aktive Produkt, jede Kollektion, jede Seite und jeden Blogbeitrag Ihres Shops ab. Eine Weiterleitung auf eine veröffentlichte Produkt-URL ist wirkungslos, bis dieses Produkt nicht mehr aufgelöst wird.
Für eine Migration heißt das, dass die Reihenfolge zählt. Nehmen Sie die alte Ressource zuerst offline oder löschen Sie sie, und bestätigen Sie dann, dass die Weiterleitung greift. Legen Sie sie an, während die Seite noch aktiv ist, sieht es aus, als wäre nichts passiert.
/services ist die Ausnahme, und dort läuft es andersherum. Eine Weiterleitung auf /services selbst liefert einen 301. Eine Weiterleitung auf alles darunter, etwa /services/consulting, liefert einen 404, obwohl der Datensatz klaglos gespeichert wird. Das wurde über etwa 45 Sekunden viermal wiederholt, um eine Verzögerung bei der Verbreitung auszuschließen, wobei der Datensatz durchgehend vorhanden war. Jedes andere Präfix aus dieser Gruppe funktionierte mit Unterverzeichnissen. Die wahrscheinliche Ursache ist, dass Shopify /services/* intern für App-Proxys und Systemendpunkte routet, sodass diese Requests die Weiterleitungstabelle nie erreichen. Den Mechanismus selbst haben wir allerdings nicht direkt überprüft.
Wer eine Website mit einem Bereich /services/ migriert, sollte wissen, dass keine dieser Weiterleitungen greift. Bilden Sie sie auf eine andere Pfadstruktur ab oder behandeln Sie sie in Ihrer DNS- oder Proxy-Schicht.
URL-Weiterleitungen anlegen und aktualisieren ist bei Shopify einfach
Eine neue Weiterleitung anzulegen ist bei Shopify unkompliziert. Nutzer haben zwei Möglichkeiten:
- Einzelne URL-Weiterleitungen, eine nach der anderen
- Weiterleitungen in großer Menge über eine CSV-Datei, hier ist die aktuelle Vorlage für diesen Import.
Beim Hinzufügen von URLs zum System von Shopify können Nutzer für den Ursprung (Weiterleiten von) relative URL-Pfade ohne Top-Level-Domain eingeben und für das Ziel (Weiterleiten nach) absolute oder relative URL-Pfade. Beispiel:
/example_product.php
Einzelne URL-Weiterleitungen anlegen
Die Weiterleitungsregeln von Shopify lassen es nicht zu, dieselbe URL-Weiterleitung zweimal anzulegen, wenn Sie die Oberfläche für einzelne Weiterleitungen nutzen.
Sobald eine URL in der Tabelle unter Weiterleiten von steht, bekommen Sie beim erneuten Hinzufügen eine Fehlermeldung.
Wenn Sie den einzelnen URL-Datensatz aktualisieren wollen, müssen Sie ihn in der Weiterleitungstabelle finden oder den Massenimport nutzen. Ist eine bereits vorhandene URL in einer Importdatei enthalten, wird das Feld Weiterleiten nach dieses Datensatzes mit dem Wert aus der CSV-Datei aktualisiert.
Unser Rat ist, Weiterleitungen immer in überschaubaren, effizienten Chargen zu importieren. Wenn Sie zum Beispiel 10.000 URL-Weiterleitungen haben, importieren Sie 1.000 auf einmal und prüfen Sie sie, wenn die Zeit reicht. Es ist besser, Fehler in kleineren Datenmengen zu erwischen, als sie in größeren zu jagen.
Beim Massenimport von URL-Weiterleitungen in Shopify mitdenken
Um Weiterleitungen in großer Menge anzulegen, füllen Sie die CSV-Datei mit den Spaltenüberschriften, die Shopify verlangt, legen die 1:1-Zuordnungen an und stellen sicher, dass alle URLs als relative Pfade formatiert sind. Wenn Sie eine Datei mit absoluten Pfaden im Feld Weiterleiten von oder Weiterleiten nach anlegen, nimmt Shopify die Sache selbst in die Hand. Hier einige Szenarien:
https://www.wislr.com/path/to/resource%20with
/path/to/resource%20with
www.wislr.com/unicode/test?value=%E2%9C%93%20co.wislr.com/mix/of%20encoded
/www.wislr.com/unicode/test?value=%E2%9C%93%20/co.wislr.com/mix/of%20encoded
wislr.com/nested/directory/structure?param1=value1
/wislr.com/nested/directory/structure?param1=value1
Die Lehre daraus: Prüfen Sie Ihre Importdatei doppelt, bevor Sie sie verwenden. Sonst legen Sie Weiterleitungsregeln an, die nicht so arbeiten, wie Sie es brauchen.
Wenn ein Weiterleitungsdatensatz bereits in der Tabelle steht und dieselben Werte in der Importdatei enthalten sind, aktualisiert Shopify den Datensatz mit den aktuellsten Daten aus der Importdatei. Das ist aus unserer Sicht ausgesprochen hilfreich, solange Sie diesen Datensatz auch aktualisieren wollen. Ein Grund mehr, die Daten doppelt zu prüfen.
Unser Rat ist, Weiterleitungen immer in überschaubaren, effizienten Chargen zu importieren. Wenn Sie zum Beispiel 10.000 URL-Weiterleitungen haben, importieren Sie 1.000 auf einmal und prüfen Sie sie, wenn die Zeit reicht. Es ist besser, Fehler in kleineren Datenmengen zu erwischen, als sie in größeren zu jagen.
Shopify erzwingt keine Obergrenze von 1.000 Zeilen pro Datei. Ein einzelner Import mit 1.051 Zeilen lief in 48 Sekunden ohne einen einzigen Fehler durch, das sind rund 1.300 Zeilen pro Minute.
Chargen von etwa 1.000 Zeilen bleiben sinnvoll, aber aus einem anderen Grund als einer harten Grenze. Kleinere Dateien scheitern nachvollziehbarer. Wenn ein Import mit 20.000 Zeilen schiefgeht, wissen Sie weit weniger darüber, welche Zeilen die Ursache waren, als wenn Sie zwanzig Dateien gefahren und die Zählwerte beobachtet hätten.
Lesen Sie nach jedem Import createdCount, updatedCount und failedCount. Ein failedCount über null ist das einzige Signal, das Sie dafür bekommen, dass Zeilen verworfen wurden.
Das oben beschriebene Verhalten bei Dubletten wurde exakt so bestätigt. Ein Pfad, der bereits in der Weiterleitungstabelle steht, bekommt sein Ziel überschrieben und wird unter updatedCount gemeldet, wobei er seine ursprüngliche Datensatz-ID behält. Damit lässt sich ein CSV-Import gefahrlos erneut ausführen, was mitten in einer Migration wirklich nützlich ist. Es bedeutet aber auch, dass eine veraltete Tabelle stillschweigend Korrekturen überschreibt, die Sie seit dem letzten Import von Hand vorgenommen haben.
Lassen Sie uns die Weiterleitungszuordnung bauen.
Wir haben Weiterleitungen in mehr als 100 Migrationen zugeordnet, darunter ein Umzug mit 27.000 URLs auf Shopify Plus. Wir bauen die Datei und prüfen sie vor dem Import gegen jede Grenze auf dieser Seite. Nach dem Umschalten lesen wir die Live-Antworten selbst, statt der Weiterleitungstabelle zu glauben.
Die Grenze von Shopify für Weiterleitungsdatensätze
Alles Gute hat seine Grenze, und die Weiterleitungsregeln von Shopify machen da keine Ausnahme. Für URL-Weiterleitungen gibt es zwei Schwellen.
Shopify-Tarife (nicht Plus):
Maximal 100.000 URL-Weiterleitungen
ShopifyPlus-Tarife:
Maximal 20.000.000 Weiterleitungen
Wir haben diese Grenzen nicht getestet, das wäre auch verrückt gewesen. Es sind die aktuell dokumentierten Angaben der Plattform. Behalten Sie sie bei der Planung Ihrer Weiterleitungen im Blick und priorisieren Sie die URLs mit dem meisten Traffic und Umsatz. Nach unserem Kenntnisstand hebt Shopify diese Grenzen nicht an, trotz beständiger Bitten aus den Support-Foren.
Die Grenze von Shopify für Zeichen in URLs
Hier wird es beim Weiterleitungssystem von Shopify interessant. Die offiziellen Hinweise von Shopify nennen keine festen Zeichengrenzen.
Um die Grenzen der Zeichenzahl einer Weiterleitung zu prüfen, haben wir zunächst sehr lange Strings gebaut und zu importieren versucht. Wir haben mit einer 2.000 Zeichen langen URL begonnen, weil Browser URI-Requests bis zu 2.083 Zeichen verarbeiten können. Hier ist das gute Stück in voller Pracht:
/2000aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBcccccccccccccccccccccccccccccccccccccccccccccccccccDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNoooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
Unsere erste Methode war, eine URL mit 2.000 Zeichen über die Vorlage für den Massenimport einzuspielen, und da schlugen die Alarme von Shopify an. Die Schwelle, die wir offiziell entdeckt haben, ist eine Grenze von 1.024 Zeichen für URL-Weiterleitungs-Strings, inklusive des vorangestellten Schrägstrichs /.
- Passed URL mit 300 Zeichen
- Passed URL mit 600 Zeichen
- Passed URL mit 1.000 Zeichen
- Failed URL mit 2.000 Zeichen
Einige wichtige und undokumentierte Weiterleitungsregeln bei Shopify
Shopify normalisiert die Buchstaben in Ihren URL-Strings. Das heißt: Ob Sie einen Groß- oder einen Kleinbuchstaben eintragen, das System beantwortet URL-Requests für diese unterschiedlichen Muster gleich. Die folgenden URLs führen alle auf dieselbe Seite, selbst wenn einzelne Datensätze existieren:
/CASE/TEST.html
/case/test.html
/Case/Test.html
Der String in Kleinbuchstaben hat Vorrang vor den anderen:
/case/test.html
In unseren Tests wurde für beide Datensätze immer die Seite /about.html ausgeliefert, obwohl zwei eindeutige Einträge unter Weiterleiten von mit unterschiedlichen Werten unter Weiterleiten nach existieren:
#1
/Case/Test.html [redirect to] /homepage
#2
/case/test.html [redirect to] /about.html
Es ist spannend und potenziell ärgerlich, dass Shopify Sie all diese eindeutigen Werte in die Weiterleitungstabelle eintragen lässt und dann nur einen davon ausliefert. Wir raten dazu, Ihre Daten sorgfältig zu prüfen, wenn Ihre URL-Taxonomie in diese Muster fallen könnte, bevor Sie nach Shopify importieren.
Sie können absolute URL-Pfade für Shopify-Weiterleitungen verwenden
Absolute URL-Pfade für Ihre Weiterleitungen sind laut unserem Test in Ordnung, wenn sie im Feld Weiterleiten nach stehen. Sie können auf jede beliebige URL zeigen. Hier ein Beispiel, in dem ein URL-Pfad beim Aufruf auf ein LinkedIn-Profil weiterleitet:
[Redirect from]
/Case/Test.html
[Redirect to]
https://www.linkedin.com/wislr
Außerdem entfernt Shopify im Feld Weiterleiten nach keine Top-Level-Domains, selbst wenn es um Ihren eigenen Shopify-Shop geht.
Parametrisierte URLs
In unseren Tests hat Shopify URLs mit Parametern erhalten, mit einigen Ausnahmen. Wenn Sie URLs haben, die mit vielen eindeutigen parametrisierten Strings indexiert wurden, dann lassen sich diese eindeutigen Strings in die Weiterleitungstabellen von Shopify eintragen und auf eindeutige Ziele führen. Wir haben diesen Test mit einer gängigen Taxonomie für solche URLs gemacht, mit UTM-Parametern. Zum Beispiel:
Dieser URL-String steht im Feld Weiterleiten von der Weiterleitungstabelle und führte an sein vorgesehenes Ziel:
/how-is-pkl?utm_campaign=301s+in+2024&utm_content=blue&utm_id=3012024&utm_medium=display&utm_source=google&utm_term=redirects
Wir haben den URL-String verändert und den letzten Parameter &utm_term=redirects entfernt, was einen 404 erzeugte:
/how-is-pkl?utm_campaign=301s+in+2024&utm_content=blue&utm_id=3012024&utm_medium=display&utm_source=google
Dieses Verhalten ließ sich in weiteren Tests mit anderen Parametern als Werten reproduzieren, was bestätigte, dass Shopify parametrisierte URLs als literale Strings behandelt. Shopify kürzt die URL nicht auf die Basis-URL zusammen, wenn Sie einen Parameter aus einer Weiterleitungs-URL entfernen, solange die URL auf der Shopify-Website nicht existiert.
Zur weiteren Bestätigung haben wir eine URL auf sich selbst zeigen lassen, was Shopify standardmäßig nicht erlaubt. Sie würden diese Meldung bekommen:
Dieser Eintrag ist erlaubt, wenn die Parameter im Feld Weiterleiten von stehen. Er stellt keine Weiterleitungsschleife dar, aber nach dem Verhalten im Browser hat unser Test gezeigt, dass Shopify diesen Datensatz ignoriert. Wird die URL unter Weiterleiten von angefordert, liefert Shopify den vollständigen parametrisierten URL-String aus und nicht, wie in der Tabelle erwartet, die Wurzelseite:
Dieser Eintrag ist erlaubt, aber Shopify hängt die Parameter nicht an die geladene Seite an, wie es die Regel erwartet. Es wird nur die Wurzel-URL geladen. Parameter werden der geladenen URL nie hinzugefügt:
Unsere letzte Beobachtung zu URLs mit Parametern ist, dass Shopify die Daten, die Sie ihm geben, in manchen Fällen umschreibt. Ja, Shopify schreibt die URL-Daten, die Sie ihm geben, für manche Parameter um.
Hier sind Beispiele, in denen unsere Tests dieses Muster gefunden haben.
Ursprüngliche Weiterleitungsdaten, die Shopify übernommen hat:
/test?name=John&Doe
Shopify hat den String so umgeschrieben, dass Doe das erste Parameterattribut im String ist:
/test?Doe&name=John
Ursprüngliche Weiterleitungsdaten, die Shopify übernommen hat:
/user?name=John&age=30&active=true
Shopify hat den String so umgeschrieben, dass die Parameter in einer neuen Reihenfolge stehen:
/user?active=true&age=30&name=John
Unsere Tests legen nahe, dass Shopify die Parameter alphabetisch sortieren will. Wir haben uns gefragt, ob das ein Fehler ist, denn wir hatten festgestellt, dass Shopify parametrisierte URLs als literale Strings behandelt. Warum diese Regel dann durch das Umsortieren der Parameter untergraben? Derzeit werden URL-Strings mit mehreren Parameterwerten ihre Struktur nie behalten. Das kann für manche Content-Management-Systeme erhebliche Folgen haben.
Drei Korrekturen zu diesem Abschnitt.
Parameter des eingehenden Requests werden an das Ziel weitergereicht. Die ursprüngliche Formulierung sagt, sie würden der geladenen URL nie hinzugefügt, und das gilt nur für die oben beschriebenen parametrisierten Quellpfade. Trägt der Quellpfad der Weiterleitung selbst keine Parameter, wird angehängt, was am Request ankommt:
GET /old-page -> 301 to /new-page
GET /old-page?utm_source=x -> 301 to /new-page?utm_source=xWeiterleitungen entfernen Parameter nicht für Sie. Das muss in einer Schicht oberhalb von Shopify passieren.
Das Umschreiben setzt auch in Kleinbuchstaben, nicht nur um. Das ausgearbeitete Beispiel oben behält seine Großbuchstaben, Shopify tut das nicht. Ein Pfad, der als /test?name=John&Doe übermittelt wird, wird als /test?doe&name=john gespeichert. Werte werden zusammen mit den Schlüsseln in Kleinbuchstaben gesetzt, eine Weiterleitungstabelle im Vergleich mit der Quelltabelle sieht also aus, als hätte der Import die Daten beschädigt.
Der Abgleich ist kein literaler String-Vergleich. Shopify normalisiert sowohl den gespeicherten Datensatz als auch den eingehenden Request, bevor es sie vergleicht, Groß- und Kleinschreibung und die Reihenfolge der Parameter spielen also keine Rolle. Gegen einen Datensatz, der als /page?doe&name=john gespeichert ist, liefern ?name=John&Doe, ?Doe&name=John und ?name=john&doe alle einen 301.
Was zählt, ist, welche Parameter vorhanden sind. Jeder Parameter im gespeicherten Pfad muss im Request auftauchen. Fehlt einer, bekommen Sie einen 404 statt einer Teilübereinstimmung. Der ursprüngliche Punkt bleibt also bestehen: Eine parametrisierte Weiterleitung greift nur bei genau dieser Kombination von Parametern.
Die UX der URL-Weiterleitungen bei Shopify braucht eine Überarbeitung
Beim ausgiebigen Einsatz des Weiterleitungswerkzeugs von Shopify haben wir manche Elemente schätzen gelernt und andere vermisst.
Diese Funktionen schätzen wir:
- Schaltflächen und Funktionen für den Massenimport von Weiterleitungen
- Filtern und schnelles Suchen in der URL-Taxonomie
- Export der URLs
- Wie leicht sich eine einzelne URL anlegen lässt
Diese Angaben und Funktionen fehlen dem Werkzeug aus unserer Sicht:
- Die Gesamtzahl der importierten URLs
- Einen einfacheren Weg, mehr als eine URL ins System zu kopieren. Wenn Sie mehr als eine URL auf einmal hinzufügen wollen, müssen Sie das Importdokument nutzen. Ein Anwendungsfall, in dem Kopieren und Einfügen helfen würde, ist eine Menge URLs, die alle auf dasselbe Ziel zeigen sollen.
Der Import ist schnell, das Rückgängigmachen nicht
Ergänzt aus dem Nachtest vom 27. Juli 2026.
Weiterleitungen in großer Menge anzulegen geht schnell. Sie in großer Menge zu entfernen nicht, und der Abstand ist groß genug, um die Planung eines Imports zu verändern.
| Vorgang | Methode | Gemessen |
|---|---|---|
| 1.051 Weiterleitungen anlegen | CSV-Import, eine einzelne Datei | 48 Sekunden |
| 1.051 Weiterleitungen löschen | urlRedirectDelete, einzeln |
226 Sekunden |
Die schnellen Mutationen zum Löschen in großer Menge sind gesperrt. urlRedirectBulkDeleteBySearch, urlRedirectBulkDeleteByIds und urlRedirectBulkDeleteAll verlangen alle den Scope write_online_store_navigation und eine aktive Benutzersitzung. Eine App, die sich mit Client Credentials authentifiziert, und so laufen die meisten Migrationsskripte, kann sie nicht aufrufen und löscht Datensatz für Datensatz.
Planen Sie Ihre Importe so, als ließen sie sich nur schwer rückgängig machen, denn genau so ist es. Prüfen Sie die Datei zuerst in einem Entwicklungsshop, oder importieren Sie in Tranchen, die Sie notfalls von Hand zurücknehmen würden. Spielen Sie keine Datei mit 50.000 Zeilen ein, die Sie nicht getestet haben, in der Annahme, Sie könnten sie schnell zurückrollen.
CSV-Import und Admin-API gehen unterschiedlich mit Dubletten um
Ergänzt aus dem Nachtest vom 27. Juli 2026.
Dieser Leitfaden ist um den CSV-Ablauf herum geschrieben, in dem ein doppelter Pfad den bestehenden Datensatz aktualisiert. Die API macht das Gegenteil:
create /existing-path -> /pages/about
(where /existing-path already redirects to /)
REJECTED: "Path has already been taken"
Wer einen CSV-Ablauf auf die Admin-API portiert, muss den bestehenden Datensatz abfragen und urlRedirectUpdate aufrufen, oder löschen und neu anlegen. Eine direkte Portierung der Importlogik scheitert an jedem Pfad, der bereits existiert.
So testen Sie Ihre Shopify-Weiterleitungen nach dem Launch
Alles bisher beschreibt, was Shopify annimmt. Nichts davon sagt Ihnen, ob die importierten Weiterleitungen im echten Shop tatsächlich arbeiten, und das ist eine andere Frage. Eine Weiterleitung kann sauber importieren, im Admin erscheinen und trotzdem nicht das tun, was Sie erwartet haben, sobald ein Theme, eine App oder ein Proxy im Weg steht.
Testen Sie von außerhalb des Shops und nicht durch Klicken im Browser, denn ein Browser verbirgt genau das, was Sie sehen müssen: den Statuscode. Fordern Sie die alte URL an und lesen Sie die Antwort-Header.
curl -sIL https://yourstore.example/old-product-url
Lesen Sie in der Ausgabe drei Dinge:
- Den Statuscode beim ersten Sprung. Sie wollen
301. Ein302ist temporär und gibt Signale anders weiter, was zählt, wenn es gerade um einen dauerhaften Umzug geht. - Die Zahl der Sprünge. Jede
HTTP/-Zeile in der Ausgabe ist ein Sprung. Zwei oder mehr heißt, Sie haben eine Kette gebaut, und die Lösung ist, die ursprüngliche Quelle auf das endgültige Ziel zu zeigen, statt den Zwischenschritt stehen zu lassen. - Den letzten Status. Die letzte Zeile sollte
200lauten. Eine Weiterleitung, die in einem404endet, ist schlimmer als gar keine Weiterleitung, weil sie in Ihrer Tabelle nach erledigt aussieht.
Testen Sie danach die Formen, die leicht vergessen werden. Führen Sie dieselbe Prüfung mit einer URL mit Tracking-Parameter durch, um zu bestätigen, dass der Query-String bis ans Ziel überlebt, dann mit der Apex-Domain zusätzlich zu www und über einfaches http statt nur https. Wir haben genau das in einem echten Shop getestet, und der Parameter kam unverändert am Ziel an. Der Punkt ist aber, es in Ihrem Shop zu prüfen und nicht einer allgemeinen Antwort zu vertrauen, denn ein Theme oder eine App kann das Ergebnis verändern.
Ein Verhalten sollten Sie kennen, bevor Sie in Panik geraten: Nach dem Ändern oder Löschen einer Weiterleitung kann ein Shopify-Edge-Knoten die alte Antwort noch rund dreißig Sekunden lang ausliefern, während eine cache-umgehende Variante derselben URL bereits die neue liefert. Geben Sie ihm eine Minute und testen Sie mit einem eindeutigen angehängten Query-String erneut, bevor Sie schließen, dass die Weiterleitung nicht griff.
Für die vollständige Abfolge rund um eine Migration statt für eine einzelne Weiterleitung arbeiten Sie sich durch die Checkliste für Website-Migrationen, die die Zuordnung, den Launch-Tag und die Beobachtung danach abdeckt, in die das hier gehört.
Fazit
Das System, das Shopify für die Verwaltung von 301-Weiterleitungen hat, reicht für die meisten Unternehmen, ist aber noch nicht auf Enterprise-Niveau. Wir hoffen, dass es sich mit der Zeit weiterentwickelt und Wildcard-Weiterleitungen sowie mehr Weiterleitungsdatensätze für die Standard- und Plus-Tarife bringt. Dass das Weiterleitungssystem nutzbar ist und die verschiedenen URL-Formate unterstützt, lässt uns Shopify mit einem starken Nützlichkeitswert bewerten.
Wenn Sie ein Projekt mit komplexen 301-Weiterleitungszuordnungen angehen und ein Team brauchen, das genau diese Art von Arbeit lebt, sprechen Sie uns an.
Häufig gestellte Fragen
Für wen ist die Wissensdatenbank von WISLR zu Shopify URL-Weiterleitungen gedacht?
Unsere Wissensdatenbank unterstützt vor allem Marken und Agenturen, die eine Website-Migration zu Shopify durchführen. Besonders wertvoll ist sie für kleine Teams, bei denen jede Stunde zählen muss: Sie hilft dabei, bis zu 100.000 URL-Weiterleitungen effizient zuzuordnen und umzusetzen.
Gibt es bei Shopify ein offizielles Hilfedokument zu URL-Weiterleitungen?
Ja, Shopify pflegt unter help.shopify.com ein offizielles Hilfedokument zu URL-Weiterleitungen. Es liefert allgemeine Hinweise zum Anlegen einzelner und massenhafter 301-Weiterleitungen, unser Leitfaden ergänzt es um genaue Angaben zu den URL-Typen und zu den Grenzen der Plattform.
Welche URL-Strings unterstützt Shopify nicht?
Shopify hat nur ein nicht unterstütztes URL-String-Format: Strings mit einem nicht kodierten Semikolon nach dem Gleichheitszeichen (z. B. /page?param=;semicolon). Alle anderen URL-Formate werden unterstützt, kodierte Semikolons und Semikolons an anderen Positionen eingeschlossen.
Unterstützt Shopify Weiterleitungen mit Wildcards oder Regex?
Nein, Shopify unterstützt in seinem nativen Weiterleitungssystem derzeit weder Wildcard-Weiterleitungen noch Regex-Muster. Diese Einschränkung gilt für Standard-Shopify-Shops und für Shopify Plus Shops gleichermaßen.
Was sind Wildcard-Weiterleitungen?
Mit Wildcard-Weiterleitungen leiten Sie mehrere URLs, die einem bestimmten Muster entsprechen, auf ein einziges Ziel um. Zum Beispiel alle URLs unter /blog/* auf /articles/*. Die Funktion wird häufig gewünscht, steht in Shopify nativ derzeit aber nicht zur Verfügung.
Kann Shopify Weiterleitungsketten verhindern?
Ja, Shopify hat eingebaute Sicherungen, die Weiterleitungsketten verhindern. Das System lässt es nicht zu, eine Weiterleitung auf eine URL anzulegen, die bereits anderswohin weitergeleitet wird.
Was sind Weiterleitungsketten?
Weiterleitungsketten entstehen, wenn URLs über mehrere Schritte weiterleiten, bevor sie am endgültigen Ziel ankommen (z. B. A→B→C). Solche Ketten können den Seitenaufbau verlangsamen und die SEO-Leistung beeinträchtigen. Das System von Shopify beugt ihnen durch sein Design vor.
Lassen sich URL-Weiterleitungen bei Shopify leicht anlegen und aktualisieren?
Ja, Shopify bietet zwei unkomplizierte Wege: das Anlegen einzelner URL-Weiterleitungen in der Oberfläche und den Massenimport über eine CSV-Datei. Beide Wege unterstützen relative und absolute URL-Pfade.
Wie legt man in Shopify URL-Weiterleitungen in großer Menge an?
Weiterleitungen in großer Menge lassen sich über das CSV-Importwerkzeug von Shopify anlegen. Wir empfehlen Chargen von 1.000 Zeilen, weil sich Fehler so leichter prüfen und verwalten lassen. Eine Vorlage für den Import finden Sie hier.
Gibt es bei Shopify eine Obergrenze für die Zahl der URL-Weiterleitungen?
Ja. Standardtarife von Shopify sind auf 100.000 URL-Weiterleitungen begrenzt, Shopify Plus Shops können bis zu 20.000.000 Weiterleitungen verwalten. Diese Grenzen liegen fest und lassen sich nicht anheben.
Gibt es bei Shopify Grenzen für die Zeichenzahl einer Weiterleitung?
Ja, Shopify setzt eine Grenze von 1.024 Zeichen für URL-Weiterleitungs-Strings, inklusive des vorangestellten Schrägstrichs (/). Längere URLs nimmt das System nicht an.
Gibt es ein Werkzeug, das URLs auf Shopify-Kompatibilität prüft?
Shopify stellt kein offizielles Prüfwerkzeug bereit, unsere umfangreichen Tests haben aber gezeigt, dass 99 Prozent der gängigen URL-Formate unterstützt werden. Zu beachten sind vor allem die Grenze von 1.024 Zeichen und nicht kodierte Semikolons nach dem Gleichheitszeichen.