OSF GuidesPreprints Help GuidesAdd Supplemental Files to a Preprint

Add Supplemental Files to a Preprint

When you share a preprint with OSF Preprints or a community preprint server, an OSF project will automatically be created so that you can add supplemental files, such as code or other materials to your preprint. Each file is given a unique, persistent URL, meaning that it can be cited or linked to individually. See the general OSF Guides for help in using the other features within the OSF project, such as using the wiki and understanding project logs.

1. Go to your OSF project or component

First, sign in to the OSF, and your dashboard will appear.

Click the My Projects tab in the navigation bar.

The "My Projects" page will appear.

Then, click All my preprints from the left sidebar.

A list of your preprints will appear in the middle pane.

Click the preprint to which you want to add supplemental files.

The "Preprint Details" page will appear.

Next, click the Visit project button on the bottom right.

You will be taken to your "Project Overview" or "Component Overview" page where you can add supplemental files.

2. Upload files

Click the Files tab in the toolbar on your "Project Overview" or "Component Overview" page.

Your "Files" page will open.

To add supplemental files to your preprint, click OSF Storage.

Please note that OSF Storage is the only storage available for files added to a preprint. You can still connect storage add-ons to your project, but the files uploaded to an add-on will not be connected to your preprint.

A toolbar will appear in the top right of the "Files" page.

You can upload files in two ways:

1. Either, click the Upload button on the toolbar, and a dialog box will open. Then, select the file that you want to upoad from the dialog box.

2. Or, drag and drop files from your desktop into your project's OSF Storage.

Upload Files

3. Manage your files

You can manage your files in two ways:

Click next to a file's name

Click next to a file's name to show a series of action buttons in the toolbar on the "Files" page:

  • Download: Click this button to download the file.
  • View: Click this button to go to the "File Details" page. See the next section for more details.
  • Check out: Click this button to prevent collaborators from making changes to the file while you're working on it (must have “Write” or “Admin” privileges).
  • Rename: Click this button to rename the file.
  • Filter: Click this button to quickly search your files.
  • i: Click this button for instructions on how to use the file browser.
Click on a file

Click on a file to view it on the "File Details" page, and the "File Details" page will open.

Use the toolbar in the top right of the "File Details" page to do the following:

  • Delete: Click this button to delete a file. Please note that you can't delete your primary preprint file.
  • Check out: Click this button to prevent collaborators from making changes to the file while you're working on it (must have “Write” or “Admin” privileges).
  • Share: Click this button to link to your file or embed it on your blog or website (The Share button will only be visible on public projects).
  • Download: Click this button to download the file.
  • View: Click this button to view your file in the main part of the screen. The View button will automatically be selected when you go to the "File Details" page.
  • Edit: Click this button to live edit your file in it's own window. Note that your file must be a plain text file in order to edit it; otherwise, this button won't be available (see the screenshot of the PDF file below). You can toggle the "View" and "Edit" buttons or select both to edit and view your file at the same time.  All file versions are saved and accessible via the Revisions button as explained below.
  • Revisions: Click this button to see or download all versions of the file.

On the left side of the page, you have access to all of your project files that you can click to view from this page. You can also tag your file to enhance discoverability.

4. View your preprint's supplemental files

Go back to your "Project Overview" or "Component Overview" page and click the View preprint button.

You will be taken to the "Preprint Details" page.

Now that you have uploaded supplemental files to your OSF project or component's OSF storage, you can see all files connected to your preprint below the file display window on the "Preprint Details" page.

Hover over a file to read the file's name. The file titled "Primary" represents your preprint.

Click on a file to view it in the file display window.