Dropbox integration

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

What you'll need

  • The Dropbox integration is available on all paid plans.
  • You can authorize one Dropbox account per user per Workspace. Different Workspaces can be integrated with different Dropbox 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 Dropbox account will not be available to anyone else through ClickUp. If you attach files from Dropbox to a ClickUp task, you can control who has access to the files by making your tasks private.

Connection types

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

Connection type Description Features Commands

Personal connection

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

Personal Connected Search:

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

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

Open Dropbox: Open Dropbox in a new tab.

Workspace connection

The Workspace owner or admins can enable Dropbox 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 both public and private files from the connected account.

When using Workspace Connected Search with Dropbox, shared folders must be accepted and opened via the share link by one person before their files and folders are displayed in search results.

 

Set up the Dropbox integration

Learn how to set up the Dropbox integration.

Search Dropbox files using Connected Search

After enabling the integration, you can use Personal or Workspace Connected Search to search Dropbox 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.

Office files including Word, Excel, and Powerpoint files are only searchable by filename.

Dropbox link previews

When you paste a Dropbox link in ClickUp, you’ll see the Inline and Preview link preview types. The preview type you select will be saved for future links that you paste. 

Link previews work in task descriptions, comments, Docs, and Chat messages. Certain ClickUp objects, like tasks, have their own preferences that override your general preference. 

To manually change a link preview type, hover over it and click the ellipsis … icon.

All Dropbox previews include the following information:

  • If available, a thumbnail
  • File name
  • File size
  • Date of the last edits made

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

Attach Dropbox files to tasks

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

Use /Slash Commands to attach Dropbox files

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

Screenshot of someone using the Dropbox slash command.

Disconnect the Dropbox integration

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

  1. Search for and select Dropbox.
  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 Dropbox integration so you can make informed security and compliance decisions before enabling it in your Workspace.

Scope Description
account_info.read Identifies the connecting user
files.metadata.read Allows indexing of files and folders
files.content.read Allows indexing of file content for search
sharing.read Allows unfurling of shared links and shows sharing info