OSF GuidesProject Files Help GuidesFile Revisions and Version Control

File Revisions and Version Control

OSF has built-in version control and retains all copies of a file added to OSF.

OSF further provides access to versions of files stored on third-party storage providers. Some storage providers limit the number of previous versions saved; check with your storage provider to understand their policies and practices related to versioning.

Uploading a new version of a file

Uploading new version of a file to OSF follows the same process as uploading the original version. See the "Uploading files guide" for details. As long as the new version of your file has the same name and is put into the same OSF storage area as the earlier version, OSF will automatically updates the file and maintain a record of all previous versions stored on OSF Storage.

View new versions of a file

New versions of files that you have previously viewed will be formatted in bold in the file tree, indicating that a new version of the file is available.

Open the project, then click the Files tab in the navigation bar.

The "Files" page will appear.

The file will be formatted in bold, indicating that a new version has been added. You can see the version number in the "Version" column.

Select the file from the list to view it.

You will be taken to the "File Detail" page, where the newest version of the file will be displayed.

View previous versions of a file

Open the "File Detail" page of the file whose version history you want to view.

The most recent version of the file will be displayed by default.

Click the Revisions button in the top right of the page.

A list of the file's version history will appear. Each version of the file has a version ID.

To view previous versions of the file, select the corresponding Version ID.

The selected version will be rendered in the file viewer.

Download previous versions of a file

In the list of versions, click the Download button next to the version that you want to download.

The file will be downloaded onto your computer.