Version History and Retention

Craft keeps history at three levels: individual files, file types, and the project as a whole. Deleted files get a safety net of their own in the Trash. This page covers where each kind of history lives, how to preview and restore older versions, and how long Craft keeps everything.

File version history

Every save records a full version of the file — whether the edit came from you, the AI assistant, or a CLI push. To browse a file's history, open the file and click the Version History icon in the top right of the editor.

• Versions are labeled with a timestamp (or a name you've given them) and show who made the save.

• The version the file currently points at has a Current badge.

• Click a version to preview it. The editor switches to a read-only view of that version, with a banner offering Exit and Restore.

• Restoring sets the file back to that version. Newer versions are not deleted, so you can restore forward again if you change your mind.

File history is pruned over time: the most recent saves are always kept, while older versions gradually thin out.

File type version history

File types are versioned too — every schema, layout, or settings change adds an entry. Open a file type for editing and switch to its Version History tab.

• Previewing a version shows its schema side by side with the current one, with each field marked as added, removed, or changed, along with that version's image settings, creation flow, and layout.

• Restoring points the file type at the older definition. Newer versions stay in history, and your existing files are not modified — their data keeps whatever fields it had.

• You can delete individual history entries you don't need. The current version can't be deleted.

File type history is pruned over time the same way.

Project versions

Clicking Create Version in the top bar snapshots the whole project — every file, folder, and file type as they exist at that moment. These snapshots are the same versions used for publishing and for starting games; see Publishing and Releases for that side of them.

To browse them, open the dropdown next to Create Version and choose Version History. Each version shows its title, version number, release notes, and age, and has four actions:

• View opens a read-only preview of the entire project at that version in a new tab.

• Restore rolls your working project back to that version.

• Promote to Published makes an older version the published one without changing your workspace.

• Delete permanently removes the version and its snapshot. This can't be undone.

Note the difference in scope: restoring a file version touches one file, while restoring a project version replaces the whole workspace.

Old project versions are pruned over time as well — recent versions are always kept, and versions in active use, like the currently published one, are never removed.

Trash

Deleting a file, folder, or file type moves it to the Trash, which you'll find at the bottom of the file tree. Deleting a folder sends its entire contents along with it.

• The Trash lists each item's type, original location, and when it was deleted. Folders expand so you can see what's inside them.

• Restore items one at a time, or select several and restore them back into the file tree together.

• Delete forever and Empty trash are permanent and can't be undone. Craft always asks for confirmation first.

Items stay in the Trash until you remove them yourself — Craft never empties it on a timer. For more on the file tree and recovering from mistakes, see Navigating Your Files. For the limits on how much a project can hold in the first place, see Platform Limits.