Shopify Polaris React wurde am 1. Oktober 2025 als veraltet eingestuft und in den Wartungsmodus versetzt; an seine Stelle treten die Polaris-Webkomponenten, die nicht an React gebunden sind. Sie funktionieren einheitlich in Admin, Checkout und Kundenkonto. Bestehende Admin-Apps laufen weiter. Dringend sind React-basierte UI-Extensions: Der Support für die Version 2025-07 endete im Juli 2026, ab 2025-10 ist Preact Pflicht.
Polaris React, seit Jahren der grundlegende Baustein, mit dem Teams bei der Entwicklung von Shopify-Apps die Admin-Oberfläche bauen, wurde am 1. Oktober 2025 offiziell als veraltet (deprecated) eingestuft und in den Wartungsmodus versetzt. Neue Funktionen oder Beiträge werden nicht mehr angenommen. Die Nachfolger, die Polaris Web Components, sind nicht an React gebunden und führen mit einer framework-agnostischen Architektur die Oberflächen Admin, Checkout und Kundenkonto unter einer gemeinsamen Struktur zusammen. Diese Änderung ist nicht nur ein Bibliotheks-Update. Für jeden Entwickler und jede Agentur mit einer aktiven App im Shopify App Store bedeutet sie einen echten Migrationszeitplan. In diesem Leitfaden erklären wir, was sich geändert hat, was „framework-agnostisch“ in der Praxis bedeutet und welche konkrete Frist für Entwickler mit React-basierten UI-Extensions gilt.
Was bedeutet framework-agnostisch?
Framework-agnostisch bedeutet, dass eine Bibliothek für Oberflächenkomponenten nicht von einem bestimmten JavaScript-Framework (etwa React oder Vue) abhängt, sondern direkt mit den Browserstandards arbeitet. Funktioniert eine Komponente nur, weil React läuft, handelt es sich um eine Abhängigkeit von React. Bleibt die Oberfläche auch dann intakt, wenn Sie statt React auf Vue oder Svelte umsteigen, ist das ein framework-agnostischer Ansatz.
Die Polaris-Webkomponenten gehören zur zweiten Kategorie: Da die Komponenten auf dem Web-Components-Standard aufbauen, lassen sie sich mit React, mit Vue oder ganz ohne Framework direkt in HTML verwenden. Diese leichtgewichtigen, modularen Komponenten werden über Shopifys eigenes CDN ausgeliefert und teilen sich vom Admin-Bereich bis zu den Checkout-Extensions dieselbe Codebasis. Früher war für jede Oberfläche eine eigene React-Implementierung nötig; heute deckt eine einzige Komponentenbibliothek alle Oberflächen ab.
Warum nimmt Shopify diese Änderung vor?
In der bisherigen Architektur von Shopify hatte jede Oberfläche (Admin-Bereich, Checkout-Extensions, Kundenkonto-Seiten) ihre eigene Komponentenimplementierung. Der Admin-Bereich wurde mit React geschrieben, die Checkout-Extensions liefen über ein separates Remote-UI-System. Das bedeutete, dass dieselbe visuelle Komponente (zum Beispiel ein Button oder ein Formularfeld) auf verschiedenen Oberflächen mit unterschiedlichen Codebasen neu geschrieben werden musste. Das erhöhte sowohl Shopifys eigenen Wartungsaufwand als auch die Lernkurve für Drittentwickler.
Der Wechsel zum Web-Components-Standard beseitigt diese Zersplitterung: Eine einzige Komponentenbibliothek nutzt die nativen APIs des Browsers und funktioniert auf allen Oberflächen gleich. Für Shopify heißt das, dass beim Hinzufügen künftiger Produktoberflächen (ein neuer Extension-Typ, ein neuer Admin-Bereich) keine React-Implementierung mehr von Grund auf geschrieben werden muss. Für Drittentwickler heißt es, dass sie eine einzige Komponentenlogik lernen und auf allen Oberflächen einsetzen können.
Der Unterschied zwischen Polaris React und den Polaris-Webkomponenten
Zeitplan für UI-Extensions: Pflichtwechsel von React zu Preact
Unabhängig davon, dass Polaris React für die Admin-Oberfläche veraltet ist, schaltet Shopify React für UI-Extensions (Erweiterungen für Checkout und Kundenkonto) gesondert und nach einem strengeren Zeitplan ab. Die API-Version 2025-07 ist die letzte, die React-basierte UI-Extensions unterstützt. Gemäß Shopifys üblicher Richtlinie, jede API-Version ein Jahr lang zu unterstützen, endete diese Unterstützung im Juli 2026; React-basierte Extensions laufen jetzt auf einer nicht mehr unterstützten Version.
Risiko, das Sie vermeiden sollten: Wenn Sie eine React-basierte UI-Extension für Checkout oder Kundenkonto haben und noch nicht auf die API-Version 2025-10 oder später umgestiegen sind, kann Ihre Extension nach Ablauf des üblichen Supportfensters aufhören zu funktionieren. Das ist keine „Änderung, die irgendwann kommt“, sondern eine Priorität, die Sie als aktives Migrationsprojekt behandeln sollten.
Was sollten Shopify-App-Entwickler jetzt tun?
Wenn Sie eine bestehende Admin-App auf Basis von Polaris React haben, besteht kein Risiko, dass die App von heute auf morgen nicht mehr funktioniert. Wartungsmodus bedeutet, dass der vorhandene Code weiterläuft, aber keine neuen Funktionen mehr bekommt. Wirklich dringend ist es bei React-basierten UI-Extensions: Diese Extensions auf die API-Version 2025-10 oder später umzustellen, sodass sie Preact und die Polaris-Webkomponenten verwenden, ist eine Aufgabe, die Sie nicht länger aufschieben sollten, weil die übliche Supportdauer im Juli 2026 abgelaufen ist.
In unseren eigenen Tests zeigt sich folgendes Bild: Die Polaris-Webkomponenten führen dieselbe Komponente problemlos auch auf einer Seite ohne React oder innerhalb eines anderen Frameworks aus; mit der früheren React-Implementierung war das nicht möglich. Die Dokumentation ist aber noch im Reifeprozess, und die Liste bekannter Fehler (common bugs) ist nicht kurz. Wer mit React-Gewohnheiten kommt, braucht etwas Zeit, um sich an die neue Komponentenlogik zu gewöhnen. Wenn Sie mit der Entwicklung einer neuen Admin-App beginnen, ist es sinnvoll, von Anfang an Web Components zu verwenden. Mit der Migration des Admin-Teils einer bestehenden React-App müssen Sie sich dagegen noch nicht beeilen; die Priorität sollte bei den UI-Extensions liegen.
Tipp: Prüfen Sie beim Umstieg auf die API-Version 2025-10 oder später nicht nur die Pflicht zu Preact, sondern auch die neue Grenze von 64 KB für die Bundle-Größe. Eine Extension, die bisher problemlos lief, kann allein deshalb im Build-Schritt fehlschlagen, weil diese Grenze überschritten wird. Die Bundle-Größe vor der Migration zu messen, ist der einfachste Weg, Überraschungen im Live-Betrieb zu vermeiden.
Wenn Sie diese Migration nicht allein stemmen, sondern mit einem erfahrenen Team planen möchten, umfasst unser Service für Shopify-Integrationslösungen und individuelle App-Entwicklung sowohl die Umstellung bestehender Extensions auf Preact als auch den Aufbau neuer Entwicklungen auf Basis der Polaris-Webkomponenten. Wenn Sie sich den allgemeinen Ablauf der Shopify-App-Entwicklung ansehen möchten, lesen Sie unseren Leitfaden zur individuellen App-Entwicklung; aktuelle Änderungen bei den Entwicklerwerkzeugen verfolgen Sie in unserem Beitrag zu den Shopify-CLI-Updates.
Häufig gestellte Fragen
Wann wurde Polaris React als veraltet eingestuft?
Am 1. Oktober 2025. Die Bibliothek wurde in den Wartungsmodus versetzt; der vorhandene Code läuft weiter, aber neue Funktionen oder Beiträge werden nicht angenommen.
Funktioniert meine bestehende Polaris-React-App dann nicht mehr?
Auf der Admin-Seite nicht sofort; Wartungsmodus bedeutet, dass der Code weiterläuft. Dringend ist es bei React-basierten UI-Extensions: Für diese Extensions ist die übliche Supportdauer im Juli 2026 abgelaufen; React-basierte Extensions laufen jetzt auf einer nicht mehr unterstützten Version.
Warum ist es wichtig, framework-agnostisch zu sein?
Ist eine Komponentenbibliothek framework-agnostisch, funktioniert sie statt mit React auch mit Vue, mit Preact oder ganz ohne Framework. Dadurch kann Shopify auf verschiedenen Oberflächen wie Admin, Checkout und Kundenkonto eine einzige gemeinsame Komponentenbibliothek verwenden.
Bis wann muss ich meine UI-Extensions auf Preact umstellen?
2025-07 ist die letzte API-Version, die React-basierte UI-Extensions unterstützt. Gemäß der üblichen Supportdauer von einem Jahr endete diese Unterstützung im Juli 2026; React-basierte Extensions laufen jetzt auf einer nicht mehr unterstützten Version. Sie sollten Ihre Extensions ohne Verzögerung auf die API-Version 2025-10 oder später umstellen, sodass sie Preact verwenden.
Sind die Polaris-Webkomponenten schon bereit für den Produktiveinsatz?
Mit der API-Version 2025-10 wurden sie als stabil eingestuft, aber die Dokumentation und die Liste bekannter Fehler befinden sich noch im Reifeprozess. Für neue Entwicklungen lassen sie sich einsetzen. Bevor Sie eine bestehende React-Admin-App migrieren, sollten Sie den aktuellen Stand prüfen.
Fazit
Dass Polaris React als veraltet eingestuft wurde, ist ein großer Schritt von Shopify, um sich auf der UI-Seite von Framework-Abhängigkeiten zu lösen. Für Entwickler von Admin-Apps birgt das kein akutes Risiko. Für Teams mit React-basierten UI-Extensions macht der im Juli 2026 beendete Support die Migration dagegen zu einer echten Priorität. Wenn Sie prüfen möchten, ob Ihre eigene Shopify-App für diese Umstellung bereit ist, können Sie Kontakt mit Nodus Works aufnehmen.
