Medusa 2.19.0 erschien am 13. August 2026 und ist jetzt die aktuelle Plattformversion. Der offizielle Titel – „Vite v7 Update, Inventory Export, Custom Fulfillment Addresses“ – fasst das Wesentliche zusammen: ein großes Infrastruktur-Upgrade und Funktionen, die Ihr Betriebsteam regelmäßig nutzt.
Wenn Sie Ihr E-Commerce-Geschäft auf Medusa betreiben, müssen Sie das Changelog nicht Zeile für Zeile lesen. Entscheidend sind drei Punkte: Was Ihr Team bekommt, was brechen könnte und was Sie Ihre Entwickler fragen sollten, bevor Änderungen in Produktion gehen. Darum geht es in diesem Beitrag.
Kurzfassung
Gute Nachrichten für den Betrieb. Sie können jetzt den Bestand als CSV exportieren, an abweichende Adressen versenden und steuern, ob Kunden bei Bestelländerungen benachrichtigt werden. Alle drei Funktionen ersetzen bisherige manuelle Umwege.
Gute Nachrichten für IT und Sicherheit. Medusa liefert jetzt einen generischen OIDC-Authentifizierungsprovider aus. Damit können Sie Mitarbeiter-Logins an Ihr bestehendes Identitätssystem anbinden.
Planungsbedarf. Dieses Release bringt drei offiziell als Breaking Changes deklarierte Änderungen sowie neue Mindestanforderungen für Hosting-Umgebung und Browser im Admin-Dashboard. Nichts davon ist dramatisch, aber Sie sollten es nicht erst am Freitagnachmittag bemerken.
Das fällt Ihren Store-Managern als Erstes auf
Beginnen wir damit – das ist die Änderung, die am ehesten am ersten Tag für Rückfragen sorgt.
Medusa 2.19 aktualisiert das Admin-Dashboard auf Vite 7.3.6 und React Router 7.18.2 – moderne Versionen der zugrundeliegenden Tools. Dadurch steigen die Mindestanforderungen an die Browser-Versionen:
| Browser | Bisher | Jetzt erforderlich |
|---|---|---|
| Chrome | 87 | 107 or newer |
| Edge | 88 | 107 or newer |
| Firefox | 78 | 104 or newer |
| Safari | 14 | 16 or newer |
Für die meisten Teams ist das kein Thema – wer einen Browser mit automatischen Updates nutzt, liegt deutlich über diesen Versionen. Relevant ist es in zwei typischen Fällen im Handel und Großhandel:
- Geteilte oder gesperrte Geräte. Lagerterminals, Kassen-PCs im Laden und alle Rechner, auf denen die IT die Browserversion festgesetzt hat.
- Ältere Macs. Safari 16 benötigt mindestens macOS Big Sur. Store-Manager mit älteren Macs müssen auf Chrome oder Firefox wechseln oder ein aktuelles Gerät nutzen.
Vor einem Upgrade lohnt sich ein fünfminütiger Check: Welche Geräte nutzt Ihr Team tatsächlich für den Admin-Zugang, und welche Browser laufen darauf? Einen veralteten Rechner jetzt zu finden, ist deutlich günstiger, als wenn später jemand keine Retoure mehr abwickeln kann.
Dasselbe Upgrade hebt auch die Node.js-Anforderung für Ihre Serverumgebung auf ^20.19.0, ^22.12.0 oder eine neuere LTS-Version an. Node 20.0–20.18 und 22.0–22.11 werden nicht mehr unterstützt. Das müssen Sie nicht selbst lösen, aber die Frage an Ihren Hoster ist berechtigt: Laufen wir auf einer unterstützten Node-Version?
Export von Lagerbeständen ist jetzt möglich
Wenn Sie Ihre aktuellen Lagerbestände schon einmal als Tabelle gebraucht haben – für Lieferantengespräche, Inventuren, Planung oder einfach für den Steuerberater – kennen Sie das: Entwickler bitten, eine Abfrage zu fahren, oder Zahlen manuell aus dem Dashboard kopieren.
Medusa 2.19 ermöglicht den Export von Lagerbeständen als CSV-Datei, sowohl über das Admin-Dashboard als auch per API. Das folgt dem gleichen Muster wie bei Produkt- und Bestellexporten in Medusa – wer diese schon genutzt hat, findet sich sofort zurecht.
Eine kleine Funktion mit großem Effekt: Ihr Operations-Team muss das Engineering seltener bemühen. Abgleiche, Lieferantenberichte und Bestandsplanung werden eigenständig möglich.
Fulfillments können jetzt an eine andere Adresse gehen
Ein Szenario, das fast jedes wachsende Geschäft trifft: Ein Kunde bestellt, aber der Artikel muss von woanders versendet werden – vom Lieferanten, Hersteller, Logistikdienstleister – oder soll an eine andere Adresse als die auf der Bestellung.
Bisher waren dafür Umwege nötig. In 2.19 gilt: Beim Anlegen eines Fulfillments können Sie eine eigene Lieferadresse unabhängig von der Versandadresse der Bestellung angeben und zusätzliche Daten an den Fulfillment-Provider übergeben.
Die praktischen Möglichkeiten:
- Drop-Shipping. Ein Fulfillment an die Adresse des Lieferanten routen, ohne die Kundenbestellung zu ändern.
- Multi-Warehouse- und 3PL-Setups. Dem Logistikpartner exakt die Adresse und Anweisungen geben, die der Versand benötigt.
- Provider-spezifische Anforderungen. Über das Feld
additional_datakann Ihr Team Carrier- oder Partner-Metadaten – Referenznummern, Hinweise, Kontocodes – übergeben, ohne für jedes neue Feld Code anpassen zu müssen.
Wenn ein Teil Ihres Katalogs nicht aus eigenem Lager versendet wird, ist das die Funktion in 2.19, über die Sie mit Ihren Entwicklern sprechen sollten.
Sie steuern die E-Mails bei Bestelländerungen
Bestelländerungen gehören zum Alltag im Kundenservice: Ein Kunde ruft an, möchte einen Artikel hinzufügen, eine Größe ändern oder etwas vor dem Versand entfernen. Bisher ließ sich das Benachrichtigungsverhalten dabei nicht steuern.
Workflows für Bestelländerungen berücksichtigen jetzt Benachrichtigungseinstellungen. Ihr Team kann beim Auslösen einer Änderung entscheiden, ob der Kunde eine E-Mail erhält – wie es Medusa schon bei anderen Bestellaktionen ermöglicht.
Hier zählt Fingerspitzengefühl. Manche Änderungen erfordern eine E-Mail – etwa wenn ein nicht lieferbarer Artikel entfernt wird. Andere sind interne Korrekturen, die beim Kunden nur für Verwirrung und Supportanfragen sorgen. Ihrem Team die Wahl zu lassen, reduziert den Kontaktaufwand spürbar.
Mitarbeiter-Logins können über Ihren Identity Provider laufen
Medusa 2.19 bringt einen generischen OIDC-Authentifizierungsprovider. OIDC (OpenID Connect) ist der offene Standard hinter den meisten Unternehmens-Identitätssystemen. Damit lässt sich Medusa an das zentrale Login Ihres Teams anbinden.
Warum ein E-Commerce-CEO auf einen Punkt achten sollte, der nach Infrastruktur klingt:
- Offboarding funktioniert wirklich. Verlässt jemand das Unternehmen, entzieht das zentrale Konto auch den Admin-Zugang. Keine Suche mehr nach verwaisten Logins mit Rückerstattungsrechten.
- Ihre bestehende Sicherheitsrichtlinie greift. MFA-Pflicht, Session-Timeouts, Zugriffsregeln – alles zentral durchgesetzt, nicht pro System neu gebaut.
- Audits werden einfacher. „Wie steuern Sie den Zugriff auf Ihr Commerce-Admin?“ lässt sich besser beantworten, wenn die Antwort lautet: „Genau wie überall sonst.“
Das ist eine Grundlage, keine fertige Integration – die Anbindung an Ihren Identity Provider ist Aufgabe Ihres Engineering-Teams. Aber das nötige Fundament ist jetzt vorhanden.
Suche läuft jetzt im Backend
Nicht nur die Authentifizierung wurde in 2.19 überarbeitet. Auch die Suche im Admin – das Suchfeld, das Ihr Team täglich nutzt – funktioniert jetzt anders.
2.19 führt ein Suchmodul mit Backend-Such-Endpoint ein, dazu eine DSL – eine strukturierte Beschreibung für den Aufbau von Suchindizes – und die Admin-Suche nutzt jetzt diesen Backend-Endpoint.
Medusa veröffentlicht dazu keine Performance-Zahlen – begegnen Sie also konkreten Geschwindigkeitsversprechen mit Skepsis. Faktisch läuft die Suche jetzt serverseitig über ein eigenes Modul, nicht mehr wie bisher. Diese Architektur ist sinnvoll, wenn Ihr Katalog groß ist oder wächst. Wer mit der Admin-Suche bei großen Katalogen unzufrieden war, sollte nach dem Upgrade neu testen – hier hat sich das Fundament geändert.
Die drei Breaking Changes, verständlich erklärt
Die Release Notes markieren drei Änderungen als Breaking. Das steckt jeweils dahinter.
1. Das Upgrade auf Vite 7 und React Router 7. Siehe oben – Browser- und Node-Anforderungen steigen. Das betrifft eigene Erweiterungen am Admin-Dashboard; diese müssen eventuell angepasst werden. Fragen Sie Ihre Entwickler, ob Sie welche im Einsatz haben.
2. Vier Methoden für Produktoptionen im JS SDK entfernt. Methoden zum Erstellen, Aktualisieren, Abrufen und Löschen von Produktoptionen entfallen; stattdessen gibt es die allgemeine Produktaktualisierung. Das betrifft nur eigenen Code oder Integrationen, die genau diese Methoden nutzen. Wer PIM-Sync oder Bulk-Produkttools einsetzt, sollte prüfen.
3. Warenkorb- und Bestellsummen sind jetzt standardmäßig enthalten. Bisher fehlten die berechneten Summen, wenn man alle Felder eines Warenkorbs oder einer Bestellung abfragte. Jetzt sind sie dabei. Das macht das Standardverhalten nachvollziehbarer, bedeutet aber auch mehr Rechenaufwand pro Anfrage. Medusas Empfehlung: Nur die Felder abfragen, die Sie wirklich brauchen. Wer im Storefront oder in Integrationen breit Bestellungen und Warenkörbe zieht, sollte nach dem Upgrade die Performance prüfen.
Ein wichtiger Punkt: Medusas Dokumentation beschreibt Updates als rückwärtskompatibel, sodass Sie das Tempo selbst bestimmen können. Die Release Notes kennzeichnen aber drei Änderungen explizit als Breaking. Beides stimmt – die Plattform nimmt Ihnen nicht unerwartet Funktionen weg, aber dieses Release erfordert gezielte Anpassungen. Verlassen Sie sich in diesem Fall auf die Release Notes.
Was Sie Ihr Team vor dem Upgrade fragen sollten
Sie müssen das Upgrade nicht selbst durchführen. Sie müssen aber sicherstellen, dass die richtigen Fragen gestellt werden. Diese hier sollten schriftlich festgehalten werden:
- Nutzen wir eine unterstützte Node-Version (^20.19.0, ^22.12.0 oder neueres LTS)? Falls nicht: Wie sieht der Plan aus?
- Mit welchen Browsern greift unser Team auf das Admin-Panel zu? Liegt einer davon unter Chrome 107 / Edge 107 / Firefox 104 / Safari 16?
- Haben wir eigene Erweiterungen für das Admin-Dashboard entwickelt und wurden diese mit Vite 7 und React Router 7 getestet?
- Verwendet unser Code noch die entfernten Methoden des product-option SDK?
- Fordern wir irgendwo alle Felder bei Warenkörben oder Bestellungen an? Falls ja: Wie wirkt sich die Änderung bei den Summen auf die Antwortzeiten aus?
- Haben wir das in einer Staging-Umgebung getestet, die der Produktion entspricht – inklusive der Datenbankmigrationen?
- Wie sieht unser Rollback-Plan aus, falls nach dem Livegang Probleme auftreten?
Das Upgrade bei Medusa ist an sich kurz: @medusajs/*-Pakete aktualisieren, neu installieren, Migrationen ausführen. Aber „kurz“ ist nicht dasselbe wie „ungeprüft im Live-Betrieb sicher“.
Sollten Sie also upgraden?
Ja – mit einem sinnvollen Zeitplan.
Die operativen Neuerungen in 2.19 beseitigen Reibungspunkte, statt neue Funktionen einzuführen, die erst erlernt werden müssen: Export von Lagerbeständen, flexible Versandadressen und Benachrichtigungssteuerung werden Ihr Team einfach nutzen. Der OIDC-Provider ist dann strategisch relevant, wenn Zugriffssteuerung und Audits tatsächlich Thema werden – was bei wachsenden Handelsunternehmen meist früher eintritt als erwartet.
Die Breaking Changes sind überschaubar und gut dokumentiert. Das reale Risiko ist nicht, dass das Upgrade scheitert, sondern dass niemand den Browser am Lagerterminal geprüft hat oder eine Admin-Erweiterung, die seit acht Monaten niemand mehr angefasst hat, plötzlich nicht mehr lädt.
Testen Sie im Staging, gehen Sie die sieben Fragen oben durch und legen Sie das Upgrade in die Produktion auf einen Morgen mit anwesenden Entwicklern und geringem Bestellaufkommen. Das ist der gesamte Plan.
Häufige Fragen
Was ist neu in Medusa 2.19?
Export von Bestandsartikeln als CSV-Datei aus dem Admin-Dashboard und per API, individuelle Lieferadressen bei Versand, Benachrichtigungseinstellungen bei Bestelländerungen, ein generischer OIDC-Authentifizierungsprovider und ein neues Suchmodul mit Admin-Suche über ein Backend-Endpoint.
Welche Mindestversionen für Browser und Node gelten für Medusa 2.19?
Das Admin-Dashboard benötigt jetzt mindestens Chrome 107, Edge 107, Firefox 104 oder Safari 16. Die Serverumgebung erfordert Node.js ^20.19.0, ^22.12.0 oder eine neuere LTS-Version – Node 20.0–20.18 und 22.0–22.11 werden nicht mehr unterstützt.
Welche Breaking Changes gibt es in Medusa 2.19?
Drei. Das Upgrade auf Vite 7 und React Router 7 hebt die Mindestanforderungen für Browser und Node an, vier Methoden für Produktoptionen wurden aus dem JS SDK entfernt und durch die allgemeine Produktaktualisierung ersetzt, und Warenkorb- sowie Bestellsummen sind jetzt standardmäßig enthalten, wenn alle Felder abgefragt werden.
Brechen meine eigenen Erweiterungen für das Admin-Dashboard?
Möglich. Das Upgrade auf Vite 7 und React Router 7 birgt hier das Risiko – jede eigene Erweiterung des Admin-Dashboards muss geprüft und ggf. angepasst werden. Fragen Sie Ihr Entwicklerteam, ob solche Erweiterungen im Einsatz sind, und testen Sie diese vor dem Upgrade.
Soll ich auf Medusa 2.19 upgraden – und wie?
Ja, mit Augenmaß. Testen Sie zuerst in einer Staging-Umgebung, gehen Sie die sieben Vorab-Fragen durch und planen Sie das Produktions-Upgrade – Medusa-Pakete aktualisieren, neu installieren, Migrationen ausführen – für einen Vormittag mit geringer Bestelllast und verfügbarer Entwicklerkapazität.
Quellen
Sie betreiben einen Store mit Medusa?
Wir übernehmen die Medusa-Entwicklung für Shops, bei denen Staging-Tests, Erweiterungsprüfung und Upgrade-Fenster – wie oben beschrieben – tatsächlich jemand verantwortet: uns. Das ist die gleiche Sorgfalt wie bei Projekten wie AURA&COs Multi-Region-Storefront auf Medusa 2.18. Wenn Sie das 2.19-Upgrade lieber abgeben möchten, sprechen Sie uns an.