OSF GuidesProject Files Help GuidesFile Revisions and Version Control

File Revisions and Version Control

OSF has built-in version control. When you add a new version of a file with the same name to your OSF project, OSF automatically updates the file and maintains a record of all previous versions stored on OSF Storage.

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.

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.