Connect Google Drive to a Project
This article is licensed under CC0 for maximum reuse.
You can connect one Google Drive folder or an entire Google Drive account to your OSF project or component. Different Google Drive folders can be linked to different components within the same project. Google Docs, Sheets, and Slides will render in your browser via OSF, but cannot be edited directly on OSF. A link about the rendered Doc, Sheet, or Slides will take you to the add-on directly, where you can edit the materials if you have the appropriate permissions.
You can add files and folders to your Google Drive folder and those files will be accessible via the OSF. Likewise, files added to your Google Drive folder in your OSF account will update your Google Drive account with that file.
The Google Drive add-on allows you to connect external content to OSF. This connection does not store or back up this content on OSF. To back up your content to OSF Storage, consider Registering Your Project.
Connect Google Drive to a project
You can link one Google Drive folder or an entire account to any OSF project, component, or your profile. Different folders can be linked to different components within the same project, but they'll need to be authenticated separately.
Files will render in-browser via OSF, but cannot be edited directly on the platform. Clicking the file title will open the document in Google Drive, where you can edit it (if you have permission).
Note: Files are not stored on OSF. The add-on creates a live connection to your Google Drive. To archive your files to OSF Storage, consider registering your project.
Setup Google Drive Account
- Open your project, then click the "Add-ons" tab in the navigation bar.
- You will be taken to the "Add-ons" page for the project. Select “Additional Storage”.
- Click “Connect” under Google Drive.
- The Google Drive terms will appear. Read the terms, then click the "Confirm" button if you agree.
- You'll be prompted to name your account.
Note: Use a clear name like "YourName_Add-on" to distinguish your connection from other collaborators'.
- Give a unique name account and click "Authorize".
Authorize Access
- A new tab will open to begin the OAuth process. (OAuth (Open Authorization) is a secure way for one app (like OSF) to access limited information or features from another service (like Google Drive) without needing your password. It lets you grant permission using your existing account, while keeping your login credentials private.)
- Click "Allow" to authorize your Google account.
- Select the Google Drive account you want to use.
- Click "Authorize".
- Click “Confirm”.
Select a Folder to Connect
- You’ll be asked to select a folder (e.g., from “My Drive”).
- Click the main folder you’d like to add.
- Click "Save".
You have now connected your Add-on to your OSF project and will be returned to the Add-on selection page. Your folder will be connected to your project on the project file page.
Managing Your Google Drive Files via the Files Tab
Once set up, you’ll use the Files tab to interact with your connected Google Drive content.
Adding Folders and Files from Google Drive
Use this to link a file or folder from your existing Google Drive account to your OSF project.
- Go to the "Files" tab in your project or component.
- Click the green ➕ button and select Add from Drive.
- A modal will appear showing the Google File Picker.
- Select a file or folder from your Drive.
Reminder: You can only select one item at a time. If you select a folder, its contents will not appear— you must add each file individually.
- Click Select to confirm. The item will now be visible in your OSF Files tab.
Upload a File
Use this to upload a file from your local device to your connected Google Drive folder.
- In the Files tab, click the green ➕ button and select "Upload File".
- A system file picker will open (macOS or Windows).
- Navigate to the file you want to upload and select it.
- A modal will appear showing upload progress.
- Once complete, click "Done". The file will be added to your connected Google Drive folder and visible on OSF.
Create Folder
Use this to create a new folder inside your connected Google Drive folder, which will be visible in both OSF and Drive.
- In the Files tab, click the green ➕ button and select Create Folder.
- Enter a name for the folder in the modal that appears.
Tip: Avoid using special characters (like / \ : * ? " < > |) to prevent sync issues.
- Click "Create Folder".
- The new folder will appear in both OSF and your Google Drive.
