Sync with Dropbox

Dropbox is the recommended sync method for 2Do. It carries every task property — including attachments, List Groups, Tag Groups, Smart Lists, and Search Presets — and is supported on iPhone, iPad, Mac, and Android.

What Dropbox Sync Supports

• All task fields — title, notes, dates, recurrence, priority, action, location, sub-tasks.
• Multiple alarms per task — every alarm survives the round-trip intact.
• Attachments — audio notes, pictures, documents, and links sync without the one-picture and one-audio limit used by CalDAV.
• List Groups, Tag Groups, Smart Lists, Search Presets — saved across devices.
• All your tags — including tags that aren't currently assigned to any task. Other sync methods only carry tags-in-use.
• List settings — list colors, groups, hidden-list choices, and Focus List visibility rules stay part of your 2Do data where the selected sync method supports them.
• Automatic background sync — 2Do for Mac syncs continuously while running.

What 2Do Stores in Dropbox

2Do uses Dropbox's App Folder permission scope — it can only read and write files inside its own dedicated folder under Apps/ in your Dropbox. 2Do cannot read, modify, or even see any other file in your Dropbox. You cannot read 2Do's task data directly in Dropbox. Dropbox is only the place where your devices exchange the sync file, not a task viewer. All communication is over SSL.

Setup

1. Open 2Do > Settings > Sync.
2. Select Dropbox as the sync method.
3. Click Connect and authorise 2Do against your Dropbox account in the browser window that opens.
4. Confirm. 2Do creates its app folder and is ready to sync.
5. Repeat on each device, signing in to the same Dropbox account. The first device to sync seeds the folder. When the second device connects, you'll be asked to choose Replace Server Data or Replace Local Data — pick the direction matching where your data lives.

Use the exact same Dropbox account on every device

2Do can only sync devices that talk to the same Dropbox account. Connecting one device to me@example.com and another to me@gmail.com — even if the data inside both is yours — will leave the two devices completely isolated from each other.

If a device isn't seeing the same tasks as the rest, the first thing to verify is that 2Do > Settings > Sync shows the same email/Dropbox username on every device. If they differ, disconnect the wrong account and re-link with the correct one.

After setup — your first sync

Close Settings and return to the main task list. Press ⌘S (or click the Sync toolbar button) to force the first sync. 2Do will then ask whether to Replace Server Data or Replace Local Data — choose carefully based on which side has the data you want to keep.

After the first sync, you can manually override the next sync any time under 2Do > Settings > Sync > Next Sync Action — pick Sync Normally, Replace Server (Dropbox) Data, or Replace Local Data before triggering the next sync. The setting auto-resets to Sync Normally afterwards.

Daily Sync

Once set up, 2Do for Mac syncs continuously in the background while running. You can also press ⌘S to force an immediate sync.

Common Issues

Dropbox v1_retired error

Dropbox has retired some API versions over time. If you see a v1_retired error, update 2Do to the latest version. Builds using deprecated Dropbox APIs can no longer connect.

504 timeout error

A 504 typically means Dropbox couldn't be reached in time. Check your network and retry. Persistent 504s usually indicate a temporary Dropbox outage; check Dropbox's status page.

509 bandwidth error

A 509 means the Dropbox App Folder bandwidth limit for free Dropbox accounts has been exceeded. Rare with normal task data; can happen if you're heavy on attachments. Wait until the quota resets, or upgrade your Dropbox plan.

Different task counts on different devices

If one device shows a different count than the rest, it likely missed a sync cycle. Open 2Do on the lagging device and force a sync (⌘S) and let it complete.

Disabling Dropbox desktop notifications for 2Do

If you also run the Dropbox desktop app, Dropbox may notify you every time 2Do updates the file. Disable file-change notifications in Dropbox preferences, or exclude the 2Do app folder from notifications.

Setting Up Another Device & Troubleshooting

• Adding another device — install 2Do, sign in to the exact same Dropbox account, and let the first sync pull your data down. See Setting up a new device for the full walk-through.
• One device showing different tasks? — see One of my devices isn't syncing correctly. The standard recovery is: run a clean sync on the most up-to-date device, then Replace Local Data on the lagging ones.
• Replace Server Data vs Replace Local Data — picking the wrong side can overwrite good data. Pause and read Replace Server Data vs Replace Local Data before confirming. You can re-trigger the choice any time under 2Do > Settings > Sync > Next Sync Action.

Privacy

• 2Do syncs through Dropbox's app-sandboxed App Folder mechanism. Inside Apps/, 2Do only sees its own dedicated 2Do folder — every other folder in your Dropbox (including other apps under Apps/) is invisible and inaccessible to it.

Don't hand-edit, rename, move, or delete the 2Do folder

The files inside Apps/2Do are not meant to be human-readable. They're an internal sync database 2Do uses to coordinate state across your devices. Editing, renaming, moving, copying, or deleting any file in this folder by hand can break sync irrevocably and cause data corruption that's difficult or impossible to recover from.

If you need to change your Dropbox setup (move accounts, reset, etc.), do it from inside 2Do > Settings > Sync — never by touching the folder directly.

• All traffic between 2Do and Dropbox is encrypted in transit (SSL).
• 2Do does not encrypt the synced data on top of Dropbox's own storage encryption — see Does 2Do encrypt synced data?.

Tips

tip

For an extra safety net, use Settings > Backups > Manage Backups > Save as... to keep milestone backups in another safe location. Backups are independent of sync, so even if Dropbox has a bad day, you've got a recovery path.