Upcoming file system update to your Dropbox team account

Overview

Dropbox is updating the structure of team folders so that they’re better organized and easier to use. This article provides a pre-migration checklist with instructions, and goes over potential issues you may encounter from the update. Please note that this update will change file paths, which may interrupt API integrations.

What to do before your file system updates

Make sure everyone on the team follows the pre-migration checklist instructions the day before updating to minimize pre- and post-migration issues. This includes team admins, members, and app developers. Expect limited access while the update takes place.

Pre-migration checklist

☑Update to the latest versions of Dropbox on desktop and mobile.

• Check that the Dropbox desktop app is running version 197 or later. Learn how to update to the latest version.
• Check that the Dropbox mobile app is running version 380 or later. Learn how to update apps on Android and iOS.
• Update third-party apps or custom API integrations to their latest versions to prevent API calls from failing.
  • To use shortcuts again, remove the old links and create new ones. 
  • Learn how to create Windows Quick access links and Mac aliases.
• If using the Dropbox for Salesforce app, check to ensure it’s running version 1.700 or later.
   

☑Manage file settings and permissions to handle file path changes.

• Check sharing permissions for top-level folders in the Manage access setting.
  • If you do not want team members to manage access to a team folder, change the Manage access setting to allow Only admins.
• Make sure top-level folders are appropriately named. 
  • Names of top-level folders will become visible in the file path to team members with access to its subfolders. 

• Switch integration file paths from absolute to relative, if available.
  • Browser URLs and absolute links will break once file paths change. Switching to relative means you won’t need to re-configure the paths after updating, but you can always manually configure the file paths after the update. 
• If you’re an app developer on a team account, you’ll need to list the contents of the team space by setting the root using “/files/list_folder” with the “Dropbox-API-Path-Root” header, and then setting the path to empty quotes (“”).
  • If an app relies on absolute paths to team folders in the member folders, and “Dropbox-API-Path-Root” isn’t set, those team folders won’t be found through those file paths once the team updates. 
  • Using the folder ID to access contents of the team folder won’t work since a relevant root is required. Learn more about how to update your integrations to this updated version of Dropbox.

☑Manage selective syncing for team folders.

• Team admins should enable team selective sync, and turn on syncing for team folders. Selective syncing for subfolders will match the top-level folder, but team selective sync is off by default to avoid syncing user folders that aren’t supposed to be synced.

Turning selective sync on makes sure that folders stay synced to team members’ computers after the update finishes, allowing them to access their files on their computer. Team admins can check the folder path report for all team folders that they want changed to Automatically sync to members’ computers.

☑Prepare your device for the update.

1. Close any open apps, and restart your device. 
2. Close any apps that automatically opened after restarting your device.
3. Pause all shortcuts and third-party app integrations. 
4. Leave the Dropbox desktop app running overnight. 

Avoid using Dropbox and making changes to files during the update to avoid unexpected issues. You’ll receive a notification once the update is complete, allowing you to continue using Dropbox as normal. 

What to do after your file system updates

Once the update is complete, team admins and members should follow the post-migration checklist to ensure their settings are appropriately configured. 

Post-migration checklist

☑Update third-party automation file paths to the new Dropbox folder name.

After this update, the name of the Dropbox folder will change from “Dropbox [team name]” to “[Team name] Dropbox”.

☑Select which folders you’d like to make available offline.

Existing team folders will default to the availability setting for new files. Check your folders post-migration to make sure that any folders that need to be available offline, are. 

☑Manage selective syncing for team folders.

Team members may need to enable selective sync individually. If you’ve been granted access to a folder but it doesn’t appear in the Dropbox desktop app, turn on selective sync for that folder. Ask your team admin for a folder path report to identify the top-level folder for your subfolders if needed.

☑Choose whether to allow team members to create team folders.

Learn more about team folders.

☑Re-check sharing permissions for folders.

To allow team members to share subfolders but not the top-level team folder, the team admin should set the Manage access setting to Admin only for top-level folders, and Team members who can edit for subfolders. This setting cascades down the team folder tree to subfolders, and is independent of the top-level content management settings. Learn more about managing access settings.
 

The default for the Manage access setting on team folders depends on where the team folder is created.
 

For example, new folders created in: 

• “/browse” will be set to Team members who can edit by default.
• The content manager by an admin will be set to Admin only by default.
   

How to reschedule the team file system update

Team admins can reschedule the date of the update from the admin console. To do so:

1. Log in to dropbox.com with your admin credentials.
2. Click Admin console.
3. Click Settings.
4. Click Team profile.
   • The scheduled date for the update shows under Filesystem update.
5. Click the first dropdown to choose a date that’s available within the calendar.
6. Click the second dropdown to choose a time.