Alte Seitenversionen in Confluence Cloud löschen

English · 日本語 · Deutsch

Von Kayabyte · Aktualisiert am 11. November 2026

Kurz gesagt: Confluence Cloud kann Seitenversionen nicht in einem Rutsch löschen und hat keine Einstellung, die nur die neuesten N Versionen behält; beides sind offene Wünsche (CONFCLOUD-46541 und CONFCLOUD-27701, beide „Gathering Interest”, geprüft am 11. November 2026). Sie können eine Seitenversion nach der anderen im Seitenverlauf löschen, alte Anhangsversionen in der Anhangsliste einer Seite löschen oder die REST-API skripten. Pruner: Version History Cleanup for Confluence wendet eine Regel „die neuesten N behalten” auf Seiten und Anhänge an, mit Vorschau.

Eine Seite, die über Jahre bearbeitet wurde, kann Hunderte Versionen haben, und jede Version eines Anhangs ist eine vollständige Kopie der Datei. Dieser Leitfaden zeigt, was Confluence Cloud selbst kann, wo jede Option endet und was eine Aufbewahrungsregel braucht.

Option 1: Versionen einzeln im Seitenverlauf löschen

1. Öffnen Sie die Seite und dann den Seitenverlauf (die Versionsliste).
2. Wählen Sie Löschen neben einer Version, die Sie nicht mehr brauchen, und bestätigen Sie.

Gut zu wissen:

• Wenn Sie Löschen nicht sehen, fehlt Ihnen in diesem Space vermutlich die Berechtigung; fragen Sie einen Space-Administrator.
• Gelöschte Versionen landen nicht im Papierkorb und lassen sich nicht wiederherstellen (Atlassian: Seitenverlauf).
• Versionsnummern können sich nach dem Löschen ändern; verlassen Sie sich nicht darauf, dass sie gleich bleiben.
• Es ist eine Version einer Seite pro Klick. CONFCLOUD-46541 stammt genau deshalb von jemandem mit Seiten, die Hunderte Versionen haben.

Option 2: alte Anhangsversionen löschen

Meist steckt der Speicher in den Anhängen, denn jedes Hochladen einer geänderten Datei erzeugt eine neue Version.

1. Öffnen Sie die Seite, dann Details anzeigen in der schwebenden Symbolleiste, und wählen Sie Anhänge.
2. Klappen Sie den Anhang auf, um seine Versionen zu sehen.
3. Wählen Sie Löschen neben einer Version und bestätigen Sie.

Für das Löschen einer bestimmten Version brauchen Sie die Berechtigung Space-Administrator; für das Löschen einer ganzen Datei reicht Anhang löschen. Eine gelöschte Version lässt sich nicht wiederherstellen (Atlassian: hochgeladene Dateien verwalten).

Auch das geht nur Anhang für Anhang, Seite für Seite.

Option 3: die REST-API skripten

Confluence Cloud hat einen REST-Aufruf, der eine Version einer Seite löscht: DELETE /wiki/rest/api/content/{id}/version/{versionNumber} (Confluence Cloud REST API, Content-Versionen). Ein Skript, das einen Space aufräumt, würde:

1. die Seiten im Space auflisten (GET /wiki/api/v2/spaces/{id}/pages) und den Seitenlinks folgen,
2. für jede Seite die Versionen auflisten (GET /wiki/api/v2/pages/{id}/versions),
3. entscheiden, welche Versionen weg können, zum Beispiel alles außer den neuesten 10, das zugleich älter als 90 Tage ist,
4. sie mit dem Aufruf oben löschen. Weil sich Versionsnummern nach dem Löschen ändern können, lesen Sie die Liste zwischen den Aufrufen neu oder löschen Sie immer die älteste,
5. dasselbe für Anhangsversionen tun.

Wo ein Skript endet:

• Keine Vorschau. Gelöschte Versionen lassen sich nicht wiederherstellen; Sie wollen also einen Probelauf, der zeigt, was wegfällt und wie viel Speicher das freigibt.
• Berechtigungen. Seiten, die auf einzelne Personen beschränkt sind, sieht das Skript nur, wenn das ausführende Konto sie sehen kann.
• Rate Limits und Größe. Eine große Site braucht viele Aufrufe; das Skript muss blättern, wiederholen und fortsetzen können.
• Es läuft einmal. Versionen sammeln sich wieder an; jemand muss es erneut ausführen oder irgendwo betreiben und am Laufen halten.

Was eine Aufbewahrungsregel braucht

Egal womit, legen Sie zuerst fest:

• Wie viele Versionen pro Seite und pro Anhang bleiben. Die neuesten werden nie gelöscht.
• Ein Mindestalter, damit Versionen dieser Woche bleiben, auch wenn die Seite mehr als N hat.
• Welche Spaces betroffen sind. Rechts-, Richtlinien- oder Audit-Spaces brauchen oft den vollständigen Verlauf.
• Eine Vorschau mit Anzahl und Speicher vor dem ersten Löschen, und eine großzügige erste Regel (zum Beispiel 20 Versionen behalten, nur Versionen älter als 180 Tage löschen), die Sie später verschärfen.
• Ob es sich wiederholt: einmaliges Aufräumen oder jede Nacht.

Pruner: Version History Cleanup for Confluence

Pruner ist die App, die wir dafür entwickeln: eine Aufbewahrungsregel für Seiten- und Anhangsversionen in Confluence Cloud.

• Die neuesten N Versionen jeder Seite und jedes Anhangs behalten, optional nur Versionen löschen, die älter als eine bestimmte Anzahl Tage sind, und die Spaces wählen (oder leer lassen für alle Spaces).
• Die Vorschau zeigt, wie viele alte Seiten- und Anhangsversionen die Regel löschen würde, wie viel Speicher die Anhangsversionen belegen und welche Seiten die meisten alten Versionen haben. In diesem Schritt wird nichts gelöscht.
• Ein manuelles Aufräumen bestätigt ein Confluence-Administrator. Ein optionales nächtliches Aufräumen ist standardmäßig aus.
• Die aktuelle Version und der Seiteninhalt bleiben unverändert. Blogbeiträge, Kommentare und ganze Seiten werden nicht angefasst.
• Auf einzelne Personen beschränkte Seiten sind für Apps nicht sichtbar, das nächtliche Aufräumen überspringt sie also; ein manuelles Aufräumen durch einen Administrator, der sie sehen kann, schließt sie ein.
• Pruner läuft auf Atlassian Forge und ruft nichts außerhalb von Atlassian auf.

Gelöschte Versionen lassen sich nicht wiederherstellen, nutzen Sie also zuerst die Vorschau. Die Oberfläche der App ist auf Englisch. Pruner ist im Atlassian Marketplace erhältlich.

FAQ

Kann Confluence Cloud alte Seitenversionen in einem Rutsch löschen? Nein. Es gibt kein Massenlöschen und keine Einstellung, die nur die neuesten Versionen behält; beides sind offene Wünsche (CONFCLOUD-46541 und CONFCLOUD-27701). Sie können Versionen einzeln löschen oder die REST-API skripten.

Kann ich eine gelöschte Seitenversion wiederherstellen? Nein. Gelöschte Versionen landen nicht im Papierkorb und lassen sich nicht wiederherstellen. Das gilt auch für gelöschte Anhangsversionen.

Wer darf eine alte Anhangsversion löschen? Jemand mit der Berechtigung Space-Administrator. Für eine ganze Datei reicht „Anhang löschen”.

Warum haben sich die Versionsnummern nach dem Löschen geändert? Versionsnummern können sich nach dem Löschen ändern. Der Inhalt jeder verbleibenden Version bleibt gleich.

Gibt das Löschen von Versionen sofort Speicher frei? Nicht immer. Laut Atlassian wird die Speicheranzeige nur alle 4 Stunden aktualisiert.

Confluence und Atlassian sind Marken von Atlassian. Kayabyte ist ein unabhängiger Entwickler und weder mit Atlassian verbunden noch von Atlassian empfohlen oder unterstützt.