Staging-Umgebung

Die Staging-Umgebung ist eine vollständige, private Kopie Ihrer Produktionsdatenbank. Sie können Produkte, Seiten, Einstellungen und Inhalte in Staging bearbeiten, ohne den Live-Shop zu verändern — und alles auf einmal veröffentlichen, wenn Sie bereit sind.

Typische Anwendungsfälle:

Komplettes Redesign vorbereiten, ohne den laufenden Shop zu unterbrechen
Produktkatalog für eine neue Kollektion anlegen und erst zum Launch freischalten
Einen KI-Agenten Änderungen durchführen lassen und das Ergebnis vor dem Publish prüfen
Preisanpassungen für alle Produkte vorbereiten, bevor sie live gehen

Staging-Umgebung erstellen

Navigieren Sie zu Admin → Einstellungen → Staging.
Klicken Sie auf Staging-Umgebung erstellen.
Das System kopiert Ihre Produktionsdatenbank — dieser Vorgang dauert einen Moment.
Die Seite lädt sich neu und zeigt das Staging-Dashboard mit Status, Datenbankgrößen und allen verfügbaren Aktionen.

Hinweis: Pro Shop kann nur eine Staging-Umgebung gleichzeitig existieren. Möchten Sie eine neue erstellen, müssen Sie die bestehende zuerst verwerfen — oder sie direkt über Neu aus Produktion erstellen ersetzen.

Staging-Modus aktivieren

Sobald eine Staging-Umgebung vorhanden ist, können Sie den Staging-Modus ein- und ausschalten.

Öffnen Sie Admin → Einstellungen → Staging.
Aktivieren Sie den Umschalter oben im Dashboard.
Ein bernsteinfarbenes Banner erscheint am oberen Rand jeder Admin-Seite: „STAGING MODE — Changes will not affect the live store until published"
Im oberen Navigationsbereich erscheint außerdem ein bernsteinfarbener Punkt neben „Admin Panel".
Alle Änderungen, die Sie jetzt im Admin-Bereich vornehmen, werden in der Staging-Datenbank gespeichert — nicht im Live-Shop.

Um zurück zur Produktionsdatenbank zu wechseln, deaktivieren Sie den Umschalter. Banner und Punkt verschwinden sofort.

Staging per URL umschalten

Sie können Staging auch ohne das Dashboard über eine URL aktivieren oder deaktivieren:

/admin/beliebige-seite?staging=on&staging_password=<Ihr-Passwort>
/admin/beliebige-seite?staging=off&staging_password=<Ihr-Passwort>

Das Passwort finden Sie im Staging-Dashboard. Nach dem Umschalten werden Sie auf dieselbe Seite weitergeleitet — das Passwort wird dabei aus der URL entfernt.

Änderungen überprüfen (Diff-Vorschau)

Bevor Sie veröffentlichen, können Sie alle Unterschiede zwischen Staging und Produktion einsehen.

Gehen Sie zu Admin → Einstellungen → Staging.
Klicken Sie auf Änderungen überprüfen.
Ein Dialog öffnet sich und zeigt pro Tabelle die Anzahl der geänderten Einträge — farblich markiert:
- Grün = neu hinzugefügt
- Bernstein = geändert
- Rot = gelöscht
Klicken Sie auf eine Tabellenzeile, um sie aufzuklappen und die Namen der geänderten Einträge zu sehen (z. B. Produktnamen, Seitentitel, Kategorienamen).
Schließen Sie den Dialog mit Schließen, oder starten Sie den Publish direkt mit Veröffentlichen.

Gibt es keine Änderungen, zeigt der Dialog: „Keine Inhaltsänderungen zum Veröffentlichen."

Hinweis: Bei mehr als 20 Änderungen pro Tabelle wird „(20+ weitere)" angezeigt — die Gesamtzahl sehen Sie in der Tabellenzusammenfassung.

Zur Produktion veröffentlichen

Das Veröffentlichen kopiert alle Inhaltsänderungen aus Staging in einem einzigen Datenbankvorgang (atomisch) in die Produktionsdatenbank. Vor dem Zusammenführen wird automatisch ein Backup der Produktion erstellt.

Gehen Sie zu Admin → Einstellungen → Staging.
Klicken Sie auf Zur Produktion veröffentlichen.
Ein Dialog zeigt die Diff-Zusammenfassung (identisch mit „Änderungen überprüfen").
Prüfen Sie die Änderungen — Veröffentlichen bestätigen ist deaktiviert, wenn es keine Änderungen gibt.
Klicken Sie auf Veröffentlichen bestätigen.
Ein Fortschrittsbalken zeigt den Merge-Vorgang an.
Nach Abschluss erscheint eine Bestätigung mit Zeitstempel.
Sie werden gefragt, was mit der Staging-Umgebung passieren soll:
- Staging löschen — Dashboard kehrt zum leeren Zustand zurück
- Für später behalten — Staging bleibt bestehen, Staging-Modus wird automatisch deaktiviert

Was wird veröffentlicht?

Datentyp	Wird veröffentlicht?
Produkte, Kategorien, Varianten	Ja
Seiten, Blog-Beiträge, Textbausteine	Ja
Theme, Design, Navigation	Ja
Einstellungen, Versandregeln, Gutscheine	Ja
Kampagnen, Medien, Übersetzungen, SEO	Ja
Bestellungen, Kunden, Rechnungen	Nein — werden nie berührt
Admin-Konten	Nein

Falls der Publish fehlschlägt, wird die Produktionsdatenbank automatisch auf den Stand vor dem Merge zurückgesetzt. Staging bleibt unverändert und Sie können es erneut versuchen.

Staging verwerfen

Verwirft die Staging-Datenbank und alle Staging-Dateien dauerhaft.

Gehen Sie zu Admin → Einstellungen → Staging.
Klicken Sie auf Staging verwerfen.
Bestätigen Sie im Dialog mit Verwerfen (roter Button).
Staging-Datenbank und Staging-Mediendateien werden gelöscht.
Das Dashboard kehrt zum leeren Ausgangszustand zurück.

Wichtig: Alle nicht veröffentlichten Staging-Änderungen gehen dabei unwiederbringlich verloren. Ihr Staging-API-Schlüssel bleibt erhalten und kann bei der nächsten Staging-Umgebung wiederverwendet werden.

Neu aus Produktion erstellen

Wenn Ihre Staging-Umgebung veraltet ist und die Produktion sich seitdem stark weiterentwickelt hat, können Sie Staging direkt durch eine frische Kopie der aktuellen Produktion ersetzen.

Gehen Sie zu Admin → Einstellungen → Staging.
Klicken Sie auf Neu aus Produktion erstellen.
Bestätigen Sie im Dialog mit Neu erstellen.
Das alte Staging wird gelöscht und sofort eine neue Kopie der Produktion erstellt.
Das Dashboard zeigt die neue Staging-Umgebung.

Alle Änderungen im alten Staging gehen dabei verloren. Ihr Staging-API-Schlüssel bleibt erhalten.

Hinweis zum veralteten Staging: Wenn Ihre Staging-Umgebung älter als 7 Tage ist, zeigt das Dashboard eine Warnung. Das bedeutet nicht, dass Staging unbrauchbar ist — aber je länger Staging und Produktion auseinanderlaufen, desto mehr potenzielle Konflikte können beim Veröffentlichen entstehen. Im Zweifel besser neu erstellen.

Storefront-Vorschau teilen

Mit dem Vorschau-Link können Sie den Staging-Shop im Browser öffnen und den Link mit Teammitgliedern oder Kunden teilen — ohne Admin-Zugang.

Gehen Sie zu Admin → Einstellungen → Staging.
Klicken Sie auf Storefront-Vorschau.
Ein signierter Vorschau-Link wird generiert und angezeigt (gültig 24 Stunden).
Kopieren Sie den Link und öffnen Sie ihn im Browser — oder senden Sie ihn an eine andere Person.
Der Browser fragt nach Benutzername und Passwort — verwenden Sie die Vorschau-Zugangsdaten aus dem Staging-Dashboard.
Nach der Anmeldung sehen Sie den Staging-Shop mit einem bernsteinfarbenen Balken unten: „STAGING PREVIEW — These changes are not live yet"
Die Staging-Session bleibt beim Navigieren aktiv (Cookie) — eine erneute Anmeldung ist nicht nötig.

Auf der Checkout-Seite erscheint ein zusätzlicher Hinweis: „This is a staging preview — orders placed here are test orders."

Limits:

Vorschau-Links laufen nach 24 Stunden ab
Suchmaschinen ignorieren Vorschauseiten automatisch (noindex, nofollow)
Der Link allein genügt nicht — Zugangsdaten sind zusätzlich erforderlich

Vorschau-Zugangsdaten ändern

Öffnen Sie Admin → Einstellungen → Staging.
Scrollen Sie zum Abschnitt Vorschau-Zugangsdaten.
Bearbeiten Sie Benutzername und/oder Passwort.
Klicken Sie auf Speichern.

Bestehende aktive Sessions laufen weiter bis das Cookie abläuft (24 Stunden).

Effektunterdrückung

Beim Testen im Staging-Modus sollen keine echten externen Dienste ausgelöst werden. Alle vier Unterdrückungen sind standardmäßig aktiv.

Gehen Sie zu Admin → Einstellungen → Staging → Unterdrückungseinstellungen, um einzelne Optionen an- oder abzuschalten:

Einstellung	Was wird unterdrückt	Standard
PayPal-Zahlungen unterdrücken	Keine echten PayPal-API-Aufrufe; Bestellungen erhalten einen Test-Zahlungsstatus	Ein
E-Mail-Versand unterdrücken	E-Mails werden protokolliert, aber nicht per SMTP verschickt	Ein
Webhooks unterdrücken	Webhooks werden als abgeschlossen markiert, ohne HTTP-Anfragen auszulösen	Ein
Analytics-Tracking unterdrücken	Analytics-Events geben Erfolg zurück, werden aber nicht aufgezeichnet	Ein

Änderungen werden sofort wirksam. Unterdrückte E-Mails erscheinen weiterhin im Admin-E-Mail-Protokoll.

Nach dem Publish werden alle vier Unterdrückungseinstellungen automatisch auf „Ein" (unterdrückt) zurückgesetzt.

Staging-API-Schlüssel

Der Staging-API-Schlüssel gibt MCP-Tools oder CLI-Befehlen Zugriff auf die Staging-Datenbank statt auf die Produktion — so können KI-Agenten Änderungen in Staging vornehmen, die Sie anschließend manuell prüfen und veröffentlichen.

Gehen Sie zu Admin → Einstellungen → Staging.
Scrollen Sie zum Abschnitt Staging-API-Schlüssel — der Schlüssel ist standardmäßig verborgen.
Klicken Sie auf Anzeigen, um den vollständigen Schlüssel zu sehen.
Klicken Sie auf Kopieren, um ihn in die Zwischenablage zu kopieren.

Der Schlüssel bleibt über Verwerfungs- und Neuerstellungszyklen hinweg erhalten — Sie müssen ihn in Ihrem MCP-Client oder Ihrer CLI-Konfiguration nur einmal eintragen.

MCP-Client: Verwenden Sie den Staging-Schlüssel als Authorization: Bearer-Header anstelle Ihres normalen API-Schlüssels. MCP-Tool-Antworten enthalten dann "isStaging": true, damit der Agent erkennt, dass er mit der Staging-Datenbank kommuniziert. Details finden Sie unter MCP-Server & API-Schlüssel.

CLI: Übergeben Sie den Staging-Schlüssel mit dem Flag --staging. Details finden Sie in der CLI-Referenz.

Häufige Fragen

Sehen Kunden im Live-Shop etwas von Staging?
Nein. Der Live-Shop liest immer aus der Produktionsdatenbank — unabhängig davon, ob der Staging-Modus ein- oder ausgeschaltet ist.

Kann ich beim Publish einzelne Änderungen auswählen?
Nein. Beim Publish werden immer alle Inhaltsunterschiede zwischen Staging und Produktion übertragen. Selektives Veröffentlichen einzelner Tabellen oder Einträge ist nicht möglich.

Was passiert, wenn der Publish fehlschlägt?
Die Produktionsdatenbank wird automatisch auf den Stand vor dem Merge zurückgesetzt. Die Staging-Umgebung bleibt unverändert und Sie können es erneut versuchen.

Was passiert mit meinem Staging-API-Schlüssel nach dem Verwerfen?
Der Schlüssel wird aufbewahrt. Wenn Sie eine neue Staging-Umgebung erstellen, ist er sofort wieder einsatzbereit — ohne neue Konfiguration.

Kann ich mehrere Staging-Umgebungen gleichzeitig betreiben?
Nein. Pro Shop gibt es genau eine Staging-Umgebung. Wenn Sie eine weitere benötigen, verwerfen Sie die bestehende oder erstellen Sie sie neu aus der Produktion.

Nächste Schritte

MCP-Server & API-Schlüssel — Staging-API-Schlüssel im MCP-Client einrichten
KI-Agent per MCP verbinden — MCP-Verbindung konfigurieren und erste Tool-Aufrufe ausführen
CLI-Referenz — --staging-Flag für CLI-Befehle