1. Home
  2. Adapters
  3. Dropbox Business (Admin)

Dropbox Business (Admin)

DESCRIPTION:  Dropbox is a cloud provider operating from www.dropbox.com. Dropbox for Business provides a collaborative, multi-user environment for Dropbox.  The Dropbox for Business system is required for account mapping (in which data from multiple accounts on a source is transferred to corresponding accounts on the target), and is only available if you have purchased account mapping. You must have Dropbox admin credentials to use this system.

Dropbox supports external owners (who have shared data with internal owners) and sharees. You must select Include Shared Folders to expose externally owned data; review precautions for using Include Shared Folders before migrating data with it.
SUPPORTED POPS:  All cloud POPs; CFP-West recommended.

System Fields:

The Dropbox for Business system has no system-specific fields to complete.

Dropbox Source and Target Node Configuration

Source Node Configuration

SOURCE ACCOUNT LIST Select the account(s) you wish to transfer. If you select multiple accounts, you will transfer the entire contents of each account. If you select a single account, you will see an additional field, Source Files and Folders. You can select all of the data from the one account using the Source Files and Folders selector, or you can select a subset of the data in the one account.

SOURCE FILES AND FOLDERS This field will only be displayed if a single account is selected from the Source Account List chooser. Note that folders that are shared with the current user will be displayed in the Source Files and Folders even if they are not the owner of those folders.

Target Node Configuration

TARGET TEAM MEMBER  The account that will receive all files from the source. Note that if you select a team member, it will nullify any directives from the spreadsheet for account mapping. If you are running account mapping, this field should be left blank.

DESTINATION FOLDER  Select the folder name into which you wish to transfer your files on the target (destination) server.

Exclude Shared Folders Filters out shared folders from the file chooser on the target. If there are a lot of Team Folders, this can speed up listing of the Dropbox target.

Advanced Dropbox Fields

About Batch Uploads

Batch uploads are a Dropbox technology that accelerates file uploads to Dropbox.  Do not change batch settings unless instructed to do so by Tervela.

BATCH COMPLETION POLL INTERVAL Sets the interval in milliseconds to check for whether the Dropbox batch upload is complete.

MAX TIME PER UPLOAD BATCH SETS Sets the time in milliseconds for each batch of files to be gathered.

MAX FILES PER UPLOAD BATCH Sets the max time in milliseconds for uploading a batch file set to Dropbox.  A setting of 0 disables batch uploads.

MAXIMUM NUMBER OF BATCHES THAT CAN BE OUTSTANDING  When exceeded, continue to grow the existing batch rather than creating a new one.

MILLISECONDS BEFORE CHECKING FOR EACH BATCH COMPLETION Minimum time before checking that each batch is complete.

MAX BYTES PER UPLOAD BATCH A setting of 0 disables the byte limit.

TARGET EXCLUDE FILES The defaults for these fields exclude files not supported for transfer to Dropbox. These are primarily system files, such as thumbs.db files, and temp files.

Pre-provision All Target User Accounts

Cloud FastPath cannot move data to a Dropbox account unless you have allocated storage space for it.

Account Mapping Considerations

Like many cloud service providers, Dropbox uses waterfall permissions, which means if a folder is shared with another user, all files and subfolders that are further down in the directory tree will also be shared with that user.  Dropbox does not support nested permissions at this time, meaning that if you have a shared folder, you cannot apply separate permissions to any of its subfolders unless it is a Team folder.

Unsupported Files and Characters

The below files and characters will not be migrated into Dropbox:

  • Files starting with a tilde (~) and ending with .tmp
  • Files that start with the following characters:
    • ~$
    • .~
  • Files with the following names:
    • .ds_store
    • thumbs.db
    • desktop.ini
    • icon\r
    • .dropbox
    • .dropbox.attr

Dropbox Paper files are not migrated out of Dropbox at this time.

Users with Trailing # Signs

Occasionally, sharees for a Dropbox source job will display in the users and paths tabs of the spreadsheet with a trailing # symbol (e.g. joe@company.com#).  These are users who once shared data on the source as internal users, but have since been deleted from the account.  At that point, Dropbox considers those users to be external sharees. Most customers skip these users in the spreadsheet, but they may also be mapped to valid target accounts, including the admin account.

About Team Folders

Team folders in Dropbox support nested sharing. They can only be shared with Groups at the top level, but can be shared with additional Groups and Users further down in the tree. Existing Team folders are displayed in the Target Paths tab, and new Team folders may be created in this same tab. If you are planning to send data to a Team Folder, be sure the Include Shared Folders checkbox is selected for the Dropbox target node of your job.  Don’t forget to add any needed Groups to your Dropbox account that will be accessing the top level of Team Folders; this must be done before the Account Mapping spreadsheet is generated for the job.  See Account and Permissions Spreadsheet Editing and Account Mapping – Team Folders for additional details on adding and working with Team folders.

Rate Limiting

Dropbox limits how many API calls can be made against an account depending on the plan a user is on, which may cause delays. At this time, the only solution is for users to upgrade their plan.


If you are transferring into Dropbox you should be aware that there is a daily limit of approximately 400 sharing permissions in any 24 hour period. Permissions will fail if you do not speak to Dropbox about this. You can reach out to Dropbox before the migration to ensure that they whitelist this limit so that your transfer is not delayed.

Updated on September 2, 2020

Was this article helpful?

Related Articles

Leave a Comment