# Versions and trash

Recover an earlier file version, restore something deleted or reopen archived work.

Last updated 26 October 2026

Use **Versions** to undo an unwanted file edit. Use **Trash** to recover a deleted file within 30 days. Use **Archive** to keep finished work readable while taking it out of the live view.

Figure: Versions for an edit to undo, Trash for a deleted file within 30 days, Archive for finished work kept read-only

## Restore an earlier version

1. Open the file, then its name menu, and choose **Versions**.
2. Select an earlier version to inspect it.
3. Choose **Restore** to make that content current again.

Restoring adds a new version. The content it replaces stays in history, so you can return to it later.

Versions show who made the change and when, newest first. Consecutive edits by the same author in one editing session may be grouped. History doesn't preserve every keystroke or intermediate save.

Agent edits carry the agent's name. Edits made through a page are attributed to the person using it and marked as coming through the API.

## Recover a deleted file

Open **Files** and change **File view** from **Live** to **Trash**. Open the deleted item and choose **Restore** from its name menu or banner.

Deleted files stay in Trash for 30 days. Restoring brings the file back to its folder with its version history. Deleting a folder also deletes its contents; restore the parent folder first if Cabane asks for it.

## Archive and unarchive

In **Files**, open a file or folder's menu in the tree and choose **Archive**. Archived content is read-only and appears under **File view → Archive**.

To use it again, open it there and choose **Unarchive** from its name menu or banner. If it was archived through a room or parent folder, unarchive that parent first.

Archiving keeps the record available without using Trash's 30-day recovery window.

## Recover instructions too

Charters are files with version history. Restore an earlier charter to undo an unwanted instruction change. The restored instructions apply when the agent starts their next turn.