Support
phone +1 206-523-4152 or 800-315-OMNI mastodon @OmniGroup

Frequently asked questions about OmniFocus sync

How can I tell when OmniFocus has been syncing?

As of OmniFocus 2.3 for Mac and OmniFocus 2.6 for iOS, the Sync Settings have been redesigned to provide a log of recent syncs. If you suspect OmniFocus may not be syncing normally, this is a great place to check to see when OmniFocus has been checking in with the server.

In OmniFocus 3 on your iPhone or iPad, navigate to the Home screen and tap the Settings icon. In OmniFocus 2, swipe down on the OmniFocus home screen to reveal the secret bar and tap Settings (on iPhone), or drag down on the home sidebar (iPad and iPhone Plus) to reveal the secret bar, then tap Settings. From the Settings, scroll down to the Sync category and tap Last Synced to view the Sync Log. On Mac, from the Menu Bar go to **OmniFocus > Preferences > Synchronization > Show Sync Details > Log. This log records every sync OmniFocus has made, and what type of operation triggered that sync.

Why did I get a message asking to “Replace your database and start syncing”?

Sync errors like these usually appear when once device hasn’t synced with the server for at least 21 days. When this error occurs, it’s best to reconnect your OmniFocus with the sync database as soon as possible. To reconnect with the server, you’ll need to either replace the local with the server’s database (this will almost always be the preferable option) or overwrite the server and your other synced devices with the data from this device getting the error.

OmniFocus’ sync system is designed so that each device has a full copy of your database in the form of a list of changes to your actions. Before compacting those changes, OmniFocus waits to make sure that all other devices connected to the same sync account has seen them (this is why it’s important to sync all your devices regularly). When one client gets out of date, all the others have to hold onto all intermediate changes until the left-behind client syncs again.

If one client in your sync list doesn’t sync for an extended period of time (21 days or more), eventually it will become incompatible with the sync database - meaning, there’s too much of a difference between the device database (in this example, the device where you’re seeing the message) and the sync database for OmniFocus to automatically compare and consolidate the differences. To prevent this message from occurring in the future, you’ll want to ensure that each of your devices is syncing consistently. Once in a blue moon this message can appear even if you’ve been syncing regularly - often if something changes with your sync settings, or if you undergo a major OS upgrade.

To reconnect your Mac with the server after receiving this error, press Sync to proceed with downloading the server data if the server is more up-to-date, or Cancel if you don’t wish to replace your database. If the current Mac database is the most up-to-date, you can move this to the server after canceling the prompt by choosing Replace Server Database from the File menu.

On iOS, tap Keep Sync Database to replace the current device contents with the latest information from the server. If you have continued to make changes in OmniFocus for iOS after getting this prompt, and have local edits that aren’t reflected on the server, you can contact us for further assistance by tapping the Report Error option to send us an email with more information about your history.

If you’re using an older version of OmniFocus, you might see different options for reconciling this error. If you’re not sure how to proceed, please get in touch with us using the Report Error option in-app, or the contact info at the end of this article, and we’d be happy to help further.

OmniFocus sync is getting slow. Why is it taking so long?

There are a number of factors that impact sync performance.

First of all, geographic location can play a role. Our servers are located in Seattle, WA, USA. The further away you are from us, the longer it takes for that round-trip traffic to make it from your device to us and back again. Using a WebDAV host that’s geographically closer to your location is certainly an option, not to mention you can set up your own WebDAV implementation via OS X Server.

Internet connection speed is also important to take into account. This means you can have different sync experiences between the Wi-Fi network you usually use at the office and the wispy cellular connection on the edge of town. If you think your cellular connection is too slow to sync OmniFocus, try limiting sync to Wi-Fi using the instructions provided later in this article.

The size of your database also plays a part. A database with many attachments can have a large impact on sync performance, especially if you’re accessing the server from a cellular data connection on an iPhone. Here’s a support article that provides some methods for reducing the size of your OmniFocus database.

Can I sync OmniFocus without a 3G/4G/LTE cellular connection?

Certainly! It’s worth mentioning that a sync connection isn’t required in order to use OmniFocus — if you make changes to your OmniFocus database without a sync connection, the server will automatically compare those changes the next time the app syncs. If you’d prefer to disable cellular sync altogether for OmniFocus on iPhone/iPad, in the iOS Settings app under Cellular there’s a section titled Use Cellular Data For where you’re able to allow or limit any app’s access to cellular data.

I sometimes get duplicates of repeating actions. Why is that?

If a repeating action is marked complete on one device and then the same action is marked complete on another device without syncing first it will cause each completion to generate a new copy and thus a duplicate when they are synced. In other words, you’ll see a duplicate for each device where you checked off the action before syncing. To avoid this, make sure you sync before checking off these items, or if you find yourself frequently unable to sync (on a submarine in the Pacific, for example) designate one of your devices for checking off repeating tasks.

Last Modified: Dec 13, 2023

Still need help?

support@omnigroup.com
+1 206-523-4152 or 800-315-OMNI

Was this article helpful?