Will migrating from the old Dropbox for Salesforce app to B12 Dropbox keep my existing file and folder associations?
Yes. The old package linked each Salesforce record to its Dropbox folder using a hidden marker file inside the folder, for example .001xx000003ABC.sfdb, named after the record's Salesforce Id. B12 Dropbox stores that link in a proper Salesforce record instead, which is faster to query and doesn't break if a folder gets renamed or moved. A built-in migration tool converts your old marker files into these new records so nothing needs to be recreated.
How the Migration Works
An admin runs the migration in one of two modes: a scan-only pass that reports what it finds without changing anything, useful for checking scope first, and a migrate pass that actually creates the mapping records. It can be run from a checkbox in the setup wizard, which shows a live progress indicator, or via anonymous Apex for more control.
Either way, the original marker files are left in Dropbox afterwards. They're harmless and ignored by B12 Dropbox from that point on, so there's no need to delete them, though you're welcome to clean them up once you've confirmed the migration worked.
Note: records that already have a mapping, along with the marker files that mark your root or private root folders rather than an individual record, are skipped automatically so you won't end up with duplicates.
Folder Structure After You Migrate
It's worth knowing the structure B12 Dropbox expects going forward, since it's the same one your existing folders were already in under the old package: {Workspace root}/{Object name}/{Record name}, for example Salesforce Documents/Accounts/Dickenson plc. If you're using a Dropbox team folder as your workspace, the app root is left out and the structure starts from the object name instead, for example Accounts/Dickenson plc.
Only the root folder name is configurable, from your workspace settings. Renaming a record in Salesforce doesn't rename its Dropbox folder automatically either, see what happens to my Dropbox folder if I rename a Salesforce record if that matters to you.
Related Articles
• What are workspaces and how can I manage them?
• What happens to my Dropbox folder if I rename a Salesforce record?
