Search

Google Drive integration

Connect your Google Drive account with ClickUp to attach files to tasks and comments!

What you'll need

  • The Google Drive integration is available on all paid plans.
  • You can authorize one Google Drive account per user per Workspace. Different Workspaces can be integrated with different Google Drive accounts.
  • Guests and limited members with comment permissions and above can use cloud storage apps to attach files to ClickUp tasks.

The data in your Google Drive account will not be available to anyone else through ClickUp. If you attach files from Google Drive to a ClickUp task, you can control who has access to the files by making your tasks personal.

Connection types

The features and commands available depend on which type of connection you use.

Connection type Description Features Commands

Personal connection

Connect your Google Drive account with your ClickUp user account for each Workspace you've created or joined. The data in your Drive account will not be available to anyone else through ClickUp.

Personal Connected Search:

Search public and private files from your connected Google Drive account. No one else can search for files from your personal connections.

Create Attachments: Attach Google Drive files to tasks and comments. Cloud storage must be enabled.

Open Google Drive: Open Google Drive in a new tab.

Show Scratch Sheet: Open an inline Google Sheet.

Create New Google Doc: Create and open a new Google Doc in a new tab.

Create New Google Sheet: Create and open a new Google Sheet in a new tab.

Create New Google Slide: Create and open a new Google Slide in a new tab.

Workspace connection

The Workspace owner or admins can enable Google Drive as a Workspace connection.

Use this connection to give everyone access to connected search.

Workspace Connected Search:

Workspace Connected Search allows all Workspace members to search for files from the connected account. Only files available to everyone in the connected integration can be searched. If a file is restricted to a specific group of users, it won't be accessible through Workspace Connected Search.

  

Set up the Google Drive integration

Learn how to set up the Google Drive integration.

Search Google Drive files using Connected Search

After enabling the integration, you can use Personal or Workspace Connected Search to search Google Drive files in ClickUp.

AI does not ingest file content that is more than one year old. You may search file names from over one year ago, but the content will not be accessible via Connected Search.

Google Drive link previews

See live, synced visualizations of Google Drive files in your Workspace. Eliminate the need to switch between apps and potentially lose context.

Preview Google Drive links

To create a preview of a Google Drive link:

  1. Paste a Google Drive link into ClickUp.
  2. Select Preview. The first time that you paste a Google Drive link, you'll see the option to connect your account. 
    Screenshot highlighting the preview option when pasting a drive link (1).png
  3. You'll see a detailed preview of the Google Drive content in ClickUp. This preview automatically updates when changes are made to any relevant fields.

All previews include the following information:

  • Thumbnail
    • Thumbnails do not display for all link types.
  • File type
  • File size
  • Date and time of the last edits made

Screenshot of a OneDrive Word Doc link preview.png

Only members that have connected their Google Drive accounts can see your link preview content.

Mention Google Drive links

In addition to previews, you can also mention Google Drive links. Mentions provide a more condensed visualization of the content in the link.

To paste a Google Drive link as a mention:

  1. Paste a Google Drive link into ClickUp.
  2. Select Mention. The first time that you paste a Google Drive link, you'll see the option to connect your account.
  3. The link mention will display in your draft. You can add additional text and other content to your message before sending.

Screenshot of a mentioned link (1).png

Embed Google Drive files

To embed Google Drive files:

  1. Paste a Google Drive link into ClickUp.
  2. Select Preview. The first time that you paste a Google Drive link, you'll see the option to connect your account. 
  3. You'll see a detailed preview of the Google Drive content in ClickUp.
  4. Hover over the preview and click the open preview icon.
  5. Make changes to the embedded file.

You can embed the following Google Drive file types into ClickUp:

  • PDF files
  • Images
  • Videos
  • Docs
  • Presentations
  • Sheets

Embeds that require people to log in to an external site do not work on the desktop app or mobile app.

Paste Google Drive URLs

If you don't want to use previews or mentions, you can paste a Google Drive link as a traditional URL by pasting the link and clicking URL.

Attach Google Drive files to tasks

Once the integration is set up and cloud storage is enabled, you can attach Google Drive files to tasks.

Use /Slash Commands to attach Google Drive files

Type /em gdrive in a task comment to attach files in as few clicks as possible.

Create and attach a Google Doc

To create a new Google Doc from a task:

  1. Open the task.
  2. Scroll down and hover over the Attachments section.
  3. Click the plus icon to the right.
  4. Select New Google Doc.
  5. Click Create Doc. The doc will be linked to your task. 

Disconnect the Google Drive integration

If you no longer need to access Google Drive files in ClickUp, you can disconnect the integration from the App Center:

  1. Search for and select Google Drive.

  2. Depending on your connection type, select the Personal or Workspace tab.

    Only owners and admins can disconnect Workspace connections.

  3. Next to Connected, click the ellipsis ... menu.
  4. Select Disconnect.
  5. To confirm, click Disconnect.

OAuth scopes

Below is a table of all OAuth scopes for the Google Drive integration so you can make informed security and compliance decisions before enabling it in your Workspace.

Scope Description
drive Allows Drive access for indexing, previews, and link unfurling
userinfo.email Identifies the connecting Google account
userinfo.profile Identifies the connecting Google account
openid Identifies the connecting Google account
drive.activity.readonly Improves search with edit and view signals
contacts.readonly Resolves names and avatars in activity