Skip to main content
File versioning gives you visibility into the change history of any file in your project. You can browse past versions, download a specific earlier version, or restore a file to how it looked at a previous point in time. This is useful any time a file is changed accidentally, overwritten by a collaborator, or needs to be rolled back to a known-good state.

Why use this?

Recover from accidental changes

Undo unwanted edits or overwritten files by restoring a previous version without needing to recreate the file manually

Track file history

See a full record of when a file was changed, giving you transparency into modifications over time

Support team collaboration

When multiple team members work with the same files, versioning provides a safety net for conflicts and unintended changes

Audit and review

Review what a file contained at a specific point in time, useful for debugging or understanding past behavior

What’s covered?

File versioning applies to files stored within your Relevance AI project. Each time a file is modified or overwritten, a new version is created and the previous one is retained in the version history.
File versioning is a project-level feature. All project members with appropriate permissions can view version history and restore files.

Known limitation: deleted vs. moved files

The version history system currently cannot distinguish between a file that was deleted and a file that was moved to a different location. Both appear as a deletion in the version history. If a file appears missing but you believe it may have been moved rather than deleted, check other locations in your project before using version history to restore it.

How to use

View version history

1

Open the file

Navigate to the file you want to inspect within your project.
2

Open the version history panel

Click the ”…” menu on the file, then select “Version history”.
File context menu showing the Version history option
3

Browse versions

The version history panel shows all recorded versions of the file, listed from most recent to oldest. Each entry shows the timestamp of when that version was created.

Download a previous version

1

Open version history

Follow the steps above to open the version history panel for the file.
2

Find the version you want

Scroll through the version list to locate the version you want to download.
3

Download the version

Click “Download” next to the version entry. The file is downloaded to your device in its original format at that point in time.

Restore a file to an earlier version

1

Open version history

Follow the steps above to open the version history panel for the file.
2

Select the version to restore

Click on the version you want to restore.
3

Restore the version

Click “Restore this version”. The file is updated to match the selected version.
Restoring a version overwrites the current file contents. The current state is saved as a new version in the history before the restore takes place, so you can undo the restore if needed.

Use cases

A team member uploads a new file with the same name as an existing one, overwriting it. Using version history, you can find the version that existed before the upload and restore it, or download it to compare the two.
You edit a file and later discover the changes introduced a problem. Open version history, find the last known-good version, and restore it to undo the edit.
You need to check what a configuration file looked like three weeks ago for auditing or debugging purposes. Browse the version history, find the version from that time period, and download it for review.
A file appears missing and you believe it was deleted by mistake. Open version history for the file (accessible via the project’s file list even for deleted files), find the last available version, and restore it to bring the file back.

Frequently asked questions

The number of versions retained depends on your plan and any data retention policies configured for your organization. Enterprise customers can configure retention periods via Data Retention settings.
The version history shows timestamps for each version. Attribution (which user made the change) may not be available for all file types.
When you restore a file to an earlier version, the current state is saved as a new version entry in the history before the restore is applied. This means the restore itself is reversible — you can undo it by restoring the version that was current before you triggered the restore.
Yes. Version history is accessible for deleted files through the project’s file list. Locate the deleted file, open its version history, and restore the last available version to bring it back.Note the known limitation: if a file was moved rather than deleted, it will appear as deleted in version history. Check other project locations before restoring.
Yes. Retaining previous versions consumes storage. If you are on an Enterprise plan, you can use Data Retention policies to automatically remove old versions after a specified period.
File versioning is available to all projects. Enterprise customers have additional controls over how long versions are retained via the Data Retention feature.

Data Retention

Enterprise feature to automatically manage how long file versions and other data are stored in your organization

Security and data ownership

Learn more about how Relevance AI manages your data and supports data ownership requirements