Shopify URL-Weiterleitungen: die Grenzen, getestet.

Ein besseres Hilfedokument

Geschrieben und gepflegt für die Marken und Agenturen, die gerade eine Website-Migration durchführen. Vor allem dann, wenn Sie ein kleines Team sind, für das jede Stunde zählt. Dieser Leitfaden hilft Ihnen, eine Strategie aufzubauen, mit der Sie 301-Weiterleitungen bei einem Umzug zu Shopify präzise umsetzen. 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 entwickelten PHP-Website migrieren

Wenn Sie ein Projekt mit komplexen Zuordnungen für 301-Weiterleitungen vor sich haben und ein Team brauchen, das genau diese Art von Arbeit täglich macht, sprechen Sie uns an.

Shopifys Logik für URL-Weiterleitungen: Überblick

Das offizielle Shopify-Hilfedokument zu URL-Weiterleitungen finden Sie hier. Es ist ein schlankes Dokument mit allgemeinen Richtlinien, an denen sich ein Shopify-Shopmanager beim Anlegen einzelner und massenhafter 301-Weiterleitungen orientieren kann. Konkrete Angaben dazu, welche URL-Typen ein Shopify-Shop nativ unterstützt, fehlen darin, und dieser Bericht soll diese Lücken schließen.

Zusammengefasste Erkenntnisse zur URL-Weiterleitungsfunktion von Shopify

• Shopifys Logik für URL-Weiterleitungen ist sehr robust.
• Von den 100 verschiedenen URL-String-Formaten in unserem Test hat Shopify 99 funktional unterstützt.
• Eine echte Storefront-Route schlägt immer eine Weiterleitung, und zwar stillschweigend.
• Das native System unterstützt keine Wildcards für URL-Weiterleitungen.
• Das Aktualisieren bestehender Weiterleitungspfade war mit dem Importwerkzeug einfach, solange Sie Shopifys undokumentierte Regeln befolgen
• Es gibt Grenzen für die Gesamtzahl der Weiterleitungen, die Shopify- und ShopifyPlus-Shops verwalten.
• Es gibt Grenzen für die Gesamtzahl der Zeichen in einem String für eine URL-Weiterleitung.
• Der Kettenschutz greift nur teilweise. Shopify blockiert eine Richtung, und die Anlegereihenfolge kann trotzdem eine aktive Kette hinterlassen.
• Für URLs mit Parametern gelten viele Ausnahmen und Regeln.
• Die Oberfläche für die Verwaltung von URL-Weiterleitungen ist benutzerfreundlich, könnte aber mehr Details vertragen.
• Die Tests haben die Weiterleitungsoptionen für Hydrogen und Oxygen nicht untersucht.
• Wir geben Shopifys aktuellem System für URL-Weiterleitungen einen Nützlichkeitswert von 85 %.

Die Bewertung wurde um 5 % gesenkt, weil Wildcards nicht unterstützt werden, um 1 % für den einen URL-String-Typ, der nicht unterstützt wird, um 2 % für die Grenzen bei der URL-Zeichenlänge, um 3 % für das eigenwillige Verhalten bei parametrisierten URLs und um 4 % für wesentliche Angaben zur Informationsverwaltung, die in der Weiterleitungs-UX fehlen.

Erstmals getestet am 19. Juni 2024. Erneut getestet am 27. Juli 2026 an einem Live-Shop mit Shopify-Standardtarif, über die Admin GraphQL API und gegen Live-Storefront-Anfragen. Was sich zwischen beiden Durchgängen geändert hat, steht im Changelog.

Unsere Methodik beim Testen von Weiterleitungen

Wir wollten mit unseren Tests einige Fragen beantworten, um Fallstricke bei Shopifys Regeln für 301-Weiterleitungen zu vermeiden:

• Welche Zeichen oder String-Kombinationen unterstützt das System für URL-Weiterleitungen nicht?
• Gibt es Grenzen für die 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 Liste der URLs, mit der wir diese verschiedenen Bedingungen getestet haben. Die Tests wurden in einem Shopify-Standardtarif durchgeführt (nicht ShopifyPlus).

11 Erkenntnisse, die bei Shopify-Weiterleitungen helfen

Mit diesen URL-String-Typen kommt Shopify nicht zurecht

Eines von hundert getesteten String-Formaten lässt sich nicht zuverlässig weiterleiten. Shopify nimmt den Datensatz an und speichert ihn, aber ein Browser, der ihn abruft, bekommt einen 404. Es ist ein String mit einem Semikolon nach dem Gleichheitszeichen, etwa:

/page?param=;semicolon

Bemerkenswert an diesem String ist, dass Shopifys System 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, erhalten Sie einen 404-Fehler.

Dieses Verhalten weicht vom Umgang mit anderen Sonderzeichen ab. Wenn ein URL-String mit nicht kodierten Zeichen in die Adresszeile eingegeben wird, etwa mit einer geschweiften Klammer rechts:

/page?param=}

kodiert Shopify sie beim Eingang der Anfrage automatisch, und es entsteht kein 404-Fehler.

/page%7Drightbrace

Ebenfalls bemerkenswert: Andere Varianten eines URL-Strings mit einem nicht kodierten Semikolon sind in Shopifys Weiterleitungssystem gültig, etwa:

Der 404 wird nur ausgelöst, wenn ein nicht kodiertes Semikolon nach dem Gleichheitszeichen steht, und der Fehler entsteht beim Abruf und nicht beim Import. Shopify speichert den Datensatz mit dem Semikolon prozentkodiert als %3b, und eine eingehende URL mit dem rohen Semikolon trifft nie auf den kodierten Datensatz. Der Abruf der kodierten Form liefert wie gewohnt einen 301, deshalb löst die Prozentkodierung des Semikolons das Problem überall dort, wo Sie die eingehenden Links kontrollieren. 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 Supportforen 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 Option 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 leiten können. Das ist besonders nützlich bei einer Website-Migration, 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önnten 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 den Weiterleitungsprozess und stellt sicher, dass alle URLs unter /blog/ reibungslos an ihren neuen Ort unter /articles/ geleitet werden. Standard-Shops von Shopify und ShopifyPlus bieten diese Fähigkeit ohne App-Unterstützung nicht.

Der Teil, der Traffic kostet, ist: Shopify nimmt Wildcard-Syntax ohne Beanstandung an. Ein Datensatz, der als /old-blog/* angelegt wird, lässt sich speichern, erscheint in der Weiterleitungstabelle und meldet keinen Fehler. Das Sternchen wird als wörtliches Zeichen gespeichert, deshalb ist die einzige URL, auf die es je passt, eine URL, die buchstäblich ein Sternchen enthält. Das ist schlimmer als eine klare Ablehnung, weil nichts auf den Fehler hinweist, bis echter Traffic anfängt, 404 zu liefern. Lösen Sie alle Wildcards in Ihrer Weiterleitungsdatei vor dem Import in explizite Pfade auf.

Shopify tut sein Bestes, um Weiterleitungsketten zu vermeiden

Shopify hat einen Schutzmechanismus gegen Ketten, und es lohnt sich, seine Grenzen zu kennen, bevor Sie ihm vertrauen. Er weist eine Weiterleitung ab, deren Ziel bereits die Quelle einer anderen Weiterleitung ist, mit Target can't redirect to another redirect. Er weist eine Weiterleitung ab, die auf sich selbst zeigt, mit Target can't be the same as path, und er blockiert direkte Schleifen in beide Richtungen.

In diesem Test wollten wir die folgenden URL-Datensätze anlegen, was nicht erlaubt war:

Was der Schutzmechanismus nicht tut, ist die Gegenrichtung zu prüfen. Legen Sie /a auf /b an, während unter /b nichts existiert, und später /b auf /c, dann werden beide akzeptiert. Shopify betrachtet den ersten Datensatz nie erneut, und Sie haben eine aktive Kette:

GET /a
  301 to /b
  301 to /
  final: 200, 2 hops

Allein die Anlegereihenfolge entscheidet, ob eine Kette entsteht. Massenimporte wenden die Zeilen in der Reihenfolge der Datei an, und Migrationsdateien sind selten so sortiert, dass das vermieden wird. Der Schutzmechanismus ist also nichts, worauf sich eine Planung stützen sollte. Nehmen Sie nach jedem großen Import Stichproben Ihrer Weiterleitungen und zählen Sie die Sprünge:

curl -sIL https://yourstore.com/old-path -o /dev/null -w "hops: %{num_redirects}
"

Alles über 1 ist eine Kette.

Was sind Weiterleitungsketten?

Weiterleitungsketten entstehen, wenn eine URL auf eine andere URL weiterleitet, die wiederum auf eine weitere URL weiterleitet, sodass eine Abfolge oder Kette von Weiterleitungen entsteht. Das kann ungewollt passieren, wenn über die Zeit mehrere Weiterleitungen ohne saubere Pflege angelegt werden.

Weiterleitungsketten sind problematisch, weil sie Ladezeiten verlangsamen, SEO negativ beeinflussen und ein schlechtes Nutzererlebnis erzeugen können. Jede zusätzliche Weiterleitung kostet Zeit, weil der Browser jeden Schritt der Kette durchlaufen muss, bevor er das endgültige Ziel erreicht.

Wenn Sie zum Beispiel die folgenden Weiterleitungen eingerichtet haben:

/old-page redirects to /new-page
/new-page redirects to /latest-page

Ruft ein Nutzer /old-page auf, wird er zuerst zu /new-page geleitet und dann sofort weiter zu /latest-page, und daraus entsteht eine Weiterleitungskette.

Neue Regeln für das Einrichten von Weiterleitungen bei Shopify

Unsere größte Entdeckung in den Tests ist, dass Shopifys Dokumentation veraltet ist und dass die Regel darunter einfacher ist als die dokumentierte Liste reservierter Präfixe.

Eine echte Storefront-Route schlägt immer eine Weiterleitung. Wo unter einer URL tatsächlich eine Seite existiert, liefert Shopify die Seite aus und ignoriert die Weiterleitung. Der Datensatz wird angenommen, er steht in Ihrer Weiterleitungstabelle, und er bewirkt nichts. Kein Fehler, keine Warnung. Das Präfix ist nicht die entscheidende Größe. Die Existenz einer Route ist es:

/products/ai-skillset-package-001  ->  200, the product page
/products/zz20260727               ->  301, the redirect fires

Gleiches Präfix, gegenteiliges Ergebnis. Das betrifft jedes aktive Produkt, jede Kategorie, jede Seite und jeden Blogbeitrag in Ihrem Shop, nicht nur die vier Pfade, die Shopify dokumentiert. Eine Weiterleitung auf eine veröffentlichte Produkt-URL bleibt wirkungslos, bis dieses Produkt nicht mehr auflöst, und deshalb kommt es bei einer Migration auf die Reihenfolge an: Nehmen Sie die alte Ressource zuerst offline oder löschen Sie sie, und prüfen Sie danach, ob die Weiterleitung greift.

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.

/services ist die Ausnahme in dieser Gruppe und verhält sich genau umgekehrt zum Rest. Eine Weiterleitung auf /services selbst liefert einen 301. Eine Weiterleitung auf alles darunter, etwa /services/consulting, liefert einen 404, obwohl der Datensatz ohne Beanstandung gespeichert wird. Wir haben das viermal über rund 45 Sekunden erneut getestet, um eine Verzögerung bei der Verbreitung auszuschließen, und der Datensatz stand die ganze Zeit in der Tabelle. Jedes andere Präfix dieser Gruppe funktionierte mit Unterverzeichnissen.

Die wahrscheinliche Ursache ist, dass Shopify /services/* intern für App-Proxys und System-Endpunkte routet, sodass diese Anfragen die Weiterleitungstabelle nie erreichen, den Mechanismus haben wir allerdings nicht direkt verifiziert. Wenn Sie eine Website mit einem /services/-Bereich migrieren, greift keine dieser Weiterleitungen. Bilden Sie sie auf eine andere Pfadstruktur ab oder lösen Sie sie auf DNS- oder Proxy-Ebene.

Weiterleitungen anlegen und aktualisieren ist bei Shopify einfach

Eine neue Weiterleitung anzulegen ist bei Shopify unkompliziert. Es gibt zwei Wege:

• Einzelne URL-Weiterleitungen, eine nach der anderen
• Massenhaftes Anlegen über eine CSV-Datei, hier ist die aktuelle Vorlage für diesen Import.

Beim Hinzufügen von URLs können Nutzer für die Quelle (von) relative URL-Pfade ohne Top-Level-Domain eingeben und für das Ziel (zu) absolute oder relative URL-Pfade. Beispiel:

/example_product.php

Einzelne URL-Weiterleitungen anlegen

Die Weiterleitungsregeln von Shopify erlauben es nicht, dieselbe URL-Weiterleitung über die Oberfläche für einzelne Weiterleitungen zweimal anzulegen.

Sobald eine URL in der Tabelle unter „Weiterleitung von“ steht, erhalten Sie eine Fehlermeldung, wenn Sie sie erneut hinzufügen wollen.

Wenn Sie einen 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 „Weiterleitung zu“ des Datensatzes mit dem Wert aus der CSV-Datei aktualisiert.

Unser Rat lautet, Weiterleitungen immer in handhabbaren, effizienten Stapeln zu importieren. Wenn Sie zum Beispiel 10.000 URL-Weiterleitungen haben, importieren Sie 1.000 auf einmal und prüfen Sie sie, wenn Sie die Zeit dafür haben. Fehler lassen sich in kleineren Datenmengen leichter finden als in großen.

Gehen Sie beim Massenimport von Weiterleitungen in Shopify umsichtig vor

Für Massenweiterleitungen füllen Sie die CSV-Datei mit den von Shopify verlangten Spaltenüberschriften, legen die 1:1-Zuordnungen an und achten darauf, dass alle URLs als relative Pfade formatiert sind. Wenn Sie eine Datei mit absoluten Pfaden im Feld „Weiterleitung von“ oder „Weiterleitung zu“ erstellen, greift Shopify selbst ein. Hier einige Szenarien:

Die Lehre daraus ist, Ihre Importdatei vor der Verwendung doppelt zu prüfen. Sonst legen Sie Weiterleitungsregeln an, die nicht so arbeiten, wie Sie es brauchen.

Existiert ein Weiterleitungsdatensatz bereits in der Tabelle und sind dieselben Werte in der Importdatei enthalten, 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.

Shopify erzwingt keine Zeilenobergrenze je Datei. Ein einzelner Import mit 1.051 Zeilen lief in 48 Sekunden ohne Fehler durch, was rund 1.300 Zeilen pro Minute entspricht.

Stapel von etwa 1.000 Zeilen lohnen sich trotzdem, aber aus einem anderen Grund als einer harten Grenze. Kleinere Dateien scheitern verständlicher. Wenn ein Import mit 20.000 Zeilen schiefgeht, wissen Sie deutlich schlechter, welche Zeilen dafür verantwortlich waren, als wenn Sie zwanzig Dateien gefahren und die Zähler beobachtet hätten. Lesen Sie nach jedem Import createdCount, updatedCount und failedCount, denn ein failedCount ungleich null ist das einzige Signal, das Sie darauf bekommen, dass Zeilen verworfen wurden.

Ein Pfad, der schon 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 wiederholen, was mitten in einer Migration nützlich ist. Es bedeutet aber auch, dass eine veraltete Datei stillschweigend die Korrekturen überschreibt, die Sie seit dem letzten Import von Hand vorgenommen haben.

Shopifys Grenze für Datensätze von URL-Weiterleitungen

Alles Gute hat seine Grenze, und bei Shopifys Weiterleitungsregeln ist das nicht anders. Für URL-Weiterleitungen gibt es zwei Schwellen.

Shopify-Tarife (nicht Plus):

Maximal 100.000 URL-Weiterleitungen

ShopifyPlus-Tarife:

Maximal 20.000.000 Weiterleitungen

Diese Grenzen haben wir nicht getestet, das wäre verrückt gewesen. Es sind die aktuell dokumentierten Spezifikationen der Plattform. Behalten Sie sie bei der Planung Ihrer Weiterleitungen im Blick und priorisieren Sie die wichtigsten URLs nach Traffic und Umsatz. Nach unserem Kenntnisstand hebt Shopify diese Grenzen nicht an, trotz beständiger Bitten in den Supportforen.

Shopifys Grenze für Zeichen in URLs

Hier wird es bei Shopifys Weiterleitungssystem spannend. Die offiziellen Richtlinien von Shopify nennen keine strikten Zeichengrenzen.

Um die Grenzen für URL-Zeichen einer Weiterleitung zu ermitteln, 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-Anfragen bis zu 2.083 Zeichen verarbeiten können. Hier ist der Prachtkerl in voller Schönheit:

/2000aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBcccccccccccccccccccccccccccccccccccccccccccccccccccDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNoooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Unser erster Ansatz war, eine URL mit 2.000 Zeichen über die Vorlage für den Massenimport einzuspielen, und da schlugen Shopifys Alarme an. Die Schwelle, die wir offiziell ermittelt haben, liegt bei 1.024 Zeichen für Strings einer URL-Weiterleitung, einschließlich 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, die Sie über Shopify wissen sollten

Shopify normalisiert Buchstaben in Ihren URL-Strings. Das heißt, ob Sie Groß- oder Kleinbuchstaben eingeben, die Anfrage für diese verschiedenen Muster wird gleich beantwortet. Die folgenden URLs führen alle auf dieselbe Seite, auch wenn einzelne Datensätze existieren:

/CASE/TEST.html
/case/test.html
/Case/Test.html

Der kleingeschriebene String hat Vorrang vor den anderen:

/case/test.html

In unseren Tests wurde für beide Datensätze immer die Seite /about.html ausgeliefert, obwohl es zwei eindeutige Datensätze für „Weiterleitung von“ mit unterschiedlichen Werten für „Weiterleitung zu“ gibt:

#1
/Case/Test.html [redirect to] /homepage

#2
/case/test.html [redirect to] /about.html

Es ist bemerkenswert 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, bevor Sie sie nach Shopify importieren, falls Ihre URL-Taxonomie solche Muster enthalten könnte.

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 „Weiterleitung zu“ stehen. Sie dürfen auf jede beliebige URL zeigen. Hier ein Beispiel, in dem ein URL-Pfad beim Abruf auf ein LinkedIn-Profil weiterleitet:

[Redirect from]
/Case/Test.html

[Redirect to]
https://www.linkedin.com/wislr

Außerdem entfernt Shopify im Feld „Weiterleitung zu“ keine Top-Level-Domains, selbst wenn sie zu Ihrem eigenen Shopify-Shop gehören.

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, können diese eindeutigen Strings in Shopifys Weiterleitungstabellen aufgenommen werden und auf eindeutige Ziele zeigen. Wir haben diesen Test mit einer verbreiteten Taxonomie für solche URLs durchgeführt, mit UTM-Parametern. Zum Beispiel:

Dieser URL-String steht im Feld „Weiterleitung von“ der Tabelle und ist an seinem vorgesehenen Ziel angekommen:

/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 erzeugt hat:

/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ätigt hat, dass Shopify parametrisierte URLs als wörtliche 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 erhalten dann diese Meldung:

Dieser Eintrag ist erlaubt, wenn die Parameter im Feld „Weiterleitung 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 aus „Weiterleitung von“ abgerufen, liefert Shopify den vollständigen parametrisierten URL-String aus und nicht die Wurzelseite, wie es die Tabelle erwarten ließe:

Dieser Eintrag ist erlaubt, aber Shopify hängt die Parameter nicht an die geladene Seite an, wie es die Regel vorsieht. Es wird nur die Wurzel-URL geladen.

Das gilt für parametrisierte Quellpfade. Trägt der Quellpfad der Weiterleitung selbst keine Parameter, wird alles, was mit der Anfrage ankommt, an das Ziel durchgereicht:

GET /old-page              ->  301 to /new-page
GET /old-page?utm_source=x ->  301 to /new-page?utm_source=x

Weiterleitungen entfernen keine Parameter für Sie. Das Entfernen muss in einer Schicht oberhalb von Shopify passieren.

Der Abgleich ist auch kein wörtlicher String-Vergleich. Shopify normalisiert sowohl den gespeicherten Datensatz als auch die eingehende Anfrage, bevor beide verglichen werden, deshalb spielen Groß- und Kleinschreibung sowie die Reihenfolge der Parameter 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. Worauf es ankommt, ist, welche Parameter vorhanden sind: Jeder Parameter im gespeicherten Pfad muss in der Anfrage auftauchen, und fehlt einer, kommt ein 404 statt einer teilweisen Übereinstimmung.

Unsere letzte Beobachtung zu URLs mit Parametern ist, dass Shopify die Daten, die Sie übergeben, in manchen Fällen umschreibt. Ja, Shopify schreibt die URL-Daten, die Sie übergeben, für einige 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’ vorn steht, und hat ihn kleingeschrieben:

/test?doe&name=john

Werte werden zusammen mit den Schlüsseln kleingeschrieben, sodass eine Weiterleitungstabelle im Vergleich mit der Datei, aus der sie stammt, aussieht, als hätte der Import die Daten beschädigt.

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 versucht, die Parameter alphabetisch zu sortieren. Wir haben uns gefragt, ob das ein Fehler ist, denn wir haben festgestellt, dass Shopify parametrisierte URLs als wörtliche Strings behandelt, warum also diese Regel durch das Umsortieren der Parameter unterlaufen. Derzeit werden URL-Strings mit mehreren Parameterwerten ihre Struktur nie behalten. Das kann für manche Content-Management-Systeme erhebliche Folgen haben.

Shopifys UX für URL-Weiterleitungen braucht ein Update

Bei unserer intensiven Nutzung von Shopifys Weiterleitungswerkzeug haben wir einige Elemente zu schätzen gelernt und andere vermisst.

Diese Funktionen schätzen wir:

• Schaltflächen und Funktionen für den Massenimport von Weiterleitungen
• Filter und schnelle Suche in der URL-Taxonomie
• Export der URLs
• Einfaches Anlegen einer einzelnen URL

Diese Angaben und Funktionen fehlen dem Werkzeug aus unserer Sicht:

• Gesamtzahl der importierten URLs
• Ein einfacherer Weg, mehr als eine URL in das System zu kopieren. Wenn Sie mehr als eine URL auf einmal hinzufügen wollen, müssen Sie die Importdatei nutzen. Ein Anwendungsfall, in dem Kopieren und Einfügen helfen würde, wäre eine Gruppe von URLs, die alle auf dasselbe Ziel zeigen sollen.

Der Import ist schnell, das Rückgängigmachen nicht

Weiterleitungen im Massenverfahren anzulegen geht schnell. Sie im Massenverfahren zu entfernen nicht, und der Unterschied ist groß genug, um die Planung eines Imports zu verändern.

Die schnellen Mutationen zum Massenlöschen 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 muss die Datensätze einzeln löschen.

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 Duplikaten um

Dieser Leitfaden ist rund um den CSV-Ablauf 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 Beschriebene sagt, was Shopify annimmt. Nichts davon sagt Ihnen, ob die importierten Weiterleitungen im Live-Shop tatsächlich funktionieren, 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 statt durch Herumklicken im Browser, denn ein Browser verbirgt genau das, was Sie sehen müssen: den Statuscode. Rufen Sie die alte URL ab und lesen Sie die Antwort-Header.

curl -sIL https://yourstore.example/old-product-url

Lesen Sie drei Dinge aus der Ausgabe:

• Den Statuscode beim ersten Sprung. Sie wollen 301. Ein 302 ist temporär und überträgt Wert anders, was zählt, wenn es gerade um einen dauerhaften Umzug geht.
• Die Anzahl der Sprünge. Jede HTTP/-Zeile in der Ausgabe ist ein Sprung. Zwei oder mehr bedeuten, dass Sie eine Kette gebaut haben, und die Lösung ist, die ursprüngliche Quelle direkt auf das endgültige Ziel zu richten, statt den Zwischenschritt stehen zu lassen.
• Den letzten Status. Die letzte Zeile sollte 200 lauten. Eine Weiterleitung, die in einem 404 endet, ist schlimmer als gar keine Weiterleitung, weil sie in Ihrer Tabelle wie erledigt aussieht.

Testen Sie danach die Formen, die leicht vergessen werden. Führen Sie dieselbe Prüfung an einer URL mit einem Tracking-Parameter durch, um zu bestätigen, dass der Query-String bis zum Ziel erhalten bleibt, an der Apex-Domain zusätzlich zu www und über einfaches http statt nur über https. Wir haben genau das an einem Live-Shop getestet, und der Parameter kam unversehrt am Ziel an, aber der Punkt ist, das an Ihrem Shop zu prüfen statt einer allgemeinen Antwort zu vertrauen, weil ein Theme oder eine App das Ergebnis verändern kann.

Ein Verhalten sollten Sie kennen, bevor Sie in Panik geraten: Nachdem Sie eine Weiterleitung geändert oder gelöscht haben, 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 angehängten, eindeutigen Query-String erneut, bevor Sie schließen, dass die Weiterleitung nicht gegriffen hat.

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 das Monitoring danach abdeckt, in das dieser Schritt gehört.

Zum Schluss

Das System, das Shopify für die Verwaltung von 301-Weiterleitungen hat, ist für die meisten Unternehmen gut, aber noch nicht auf Enterprise-Niveau. Wir hoffen, dass es sich mit der Zeit um Wildcard-Weiterleitungen und mehr Weiterleitungsdatensätze für die Standard- und Plus-Tarife erweitert. Die Nutzbarkeit des Weiterleitungssystems und die Vielfalt der unterstützten URL-Formate bringen ihm bei uns einen starken Nützlichkeitswert ein.

Wenn Sie ein Projekt mit komplexen Zuordnungen für 301-Weiterleitungen vor sich haben und ein Team brauchen, das genau diese Art von Arbeit täglich macht, sprechen Sie uns an.

Changelog

Dieser Leitfaden wurde erstmals aus Tests vom 19. Juni 2024 veröffentlicht und am 27. Juli 2026 an einem Live-Shop mit Shopify-Standardtarif erneut getestet, über die Admin GraphQL API und gegen Live-Storefront-Anfragen. Die meisten ursprünglichen Erkenntnisse haben gehalten. Neun nicht. Der Text oben beschreibt, was Shopify heute tut, und hier steht, was sich bewegt hat.

Die Datensatzgrenzen, 100.000 in den Standardtarifen und 20.000.000 in Plus, wurden nicht erneut geprüft. Sie zu erreichen ist mechanisch möglich, seit die Import-Pipeline vermessen ist, aber das Löschen läuft mit rund 280 Datensätzen pro Minute und ohne per Skript nutzbares Massenlöschen, sodass die Bestätigung einer dokumentierten Zahl einen Live-Shop sechs Stunden oder länger mit Müll-Weiterleitungen belasten würde.

Häufig gestellte Fragen

Für wen ist die WISLR-Wissensdatenbank 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, für die jede Stunde zählt, weil sie hilft, für Kunden bis zu 100.000 URL-Weiterleitungen effizient zuzuordnen und fertigzustellen.

Gibt es ein offizielles Shopify-Supportdokument zu URL-Weiterleitungen?

Ja, Shopify pflegt unter help.shopify.com ein offizielles Hilfedokument zu URL-Weiterleitungen. Es liefert allgemeine Richtlinien für das Anlegen einzelner und massenhafter 301-Weiterleitungen, und unser Leitfaden ergänzt es um detaillierte Angaben zu URL-Typen und Plattformgrenzen.

Welche URL-Strings unterstützt Shopify nicht?

Shopify hat nur ein einziges nicht unterstütztes URL-String-Format: Strings mit einem nicht kodierten Semikolon nach dem Gleichheitszeichen (z. B. /page?param=;semicolon). Alle anderen URL-Formate, auch kodierte Semikolons und Semikolons an anderen Positionen, werden unterstützt.

Unterstützt Shopify Weiterleitungen mit Wildcards oder Regex?

Nein, Shopify unterstützt in seinem nativen Weiterleitungssystem derzeit keine Wildcard-Weiterleitungen und keine Regex-Muster. Diese Einschränkung gilt für Standard-Shopify-Shops ebenso wie für Shopify Plus.

Was sind Wildcard-Weiterleitungen?

Wildcard-Weiterleitungen erlauben es, mehrere URLs, die einem bestimmten Muster entsprechen, auf ein einziges Ziel weiterzuleiten. Ein Beispiel wäre, alle URLs unter /blog/* auf /articles/* weiterzuleiten. Diese Funktion wird häufig gewünscht, ist im nativen Funktionsumfang von Shopify aber derzeit nicht verfügbar.

Kann Shopify das Entstehen von Weiterleitungsketten verhindern?

Ja, Shopify hat eingebaute Schutzmechanismen gegen Weiterleitungsketten. Das System erlaubt es nicht, eine Weiterleitung auf eine URL anzulegen, die bereits anderswohin weitergeleitet wird.

Was sind Weiterleitungsketten?

Weiterleitungsketten entstehen, wenn URLs über mehrere Schritte weiterleiten, bevor sie das endgültige Ziel erreichen (z. B. A→B→C). Solche Ketten können Seitenladezeiten verlangsamen und die SEO-Leistung beeinträchtigen. Shopifys System hilft von Haus aus, sie zu vermeiden.

Lassen sich URL-Weiterleitungen in Shopify leicht anlegen und aktualisieren?

Ja, Shopify bietet zwei unkomplizierte Wege: das Anlegen einzelner URL-Weiterleitungen über die Oberfläche und den Massenimport per CSV-Datei. Beide Wege unterstützen relative und absolute URL-Pfade.

Wie legt man in Shopify URL-Weiterleitungen im Massenimport an?

Massenweiterleitungen lassen sich mit Shopifys CSV-Importwerkzeug anlegen. Wir empfehlen den Import in Stapeln 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 Höchstzahl an Datensätzen für URL-Weiterleitungen?

Ja. Standardtarife von Shopify sind auf 100.000 URL-Weiterleitungen begrenzt, während Shopify-Plus-Shops bis zu 20.000.000 Weiterleitungen verwalten können. Diese Grenzen sind 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 Strings einer URL-Weiterleitung durch, einschließlich des vorangestellten Schrägstrichs (/). URLs, die diese Länge überschreiten, nimmt das System nicht an.

Gibt es ein Werkzeug, um URLs auf Shopify-Kompatibilität zu prüfen?

Shopify bietet kein offizielles Prüfwerkzeug, doch unsere umfangreichen Tests haben gezeigt, dass 99 % 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.