Being an online service, Toggl lets you access your account and data via multiple platforms. Currently, you can access your Toggl account via the following apps: 

All your time tracking data is synced between these apps so that you can easily switch between them at your convenience. 

Common sync issues: Desktop apps

The Toggl desktop app (Mac, Windows, Linux) most commonly has issues when used in an office environment with a restricted internet connection, such as a proxy or a firewall. This will prevent the app from syncing your data or could even prevent you from logging into the app.  

The app will show exclamation marks next to time entries which have failed to sync. 

You might also get a message telling you the app is offline at the bottom of the main app window: 

Triggering sync manually

If you end up in a similar situation, it's best to first try triggering sync manually within the app.

 If you are using a Mac or a Linux version of the Toggl desktop app please navigate to Account > Sync to trigger sync manually. 

If you are a Windows user please click on the cogwheel icon located on the top-right corner of the main window (the timer window) and then select "sync" from the drop-down menu.

Optimizing your network

If this doesn't work, if possible, try connecting to a different network to determine if the one you are currently connected to has restrictions on it. If you see that the app doesn't have syncing issues while you are connected to a different network or if you are not able to test this out in your office environment usually the best thing to do is ask your network administrator to white-list Toggl on the network you are connected to. It also helps to make sure that ports 80 and 443 are open towards toggl.com, desktop.toggl.com, timeline.toggl.com.

Reach out to support

If the above options did not work, you should reach out to our support team. For us to assist you better it's best to share the app's local data as well when you reach out so that we can sort out the issue you are having as soon as possible. The following article describes the location of each database (.db) file.

Common sync issues: Mobile apps

Toggl mobile apps (iOS, Android) will try to sync as often as possible in the background to ensure real-time data when you open the app. However, due to iOS and Android limitations, there might be limits to how often your app syncs based on your battery life and other factors. Users on an unstable network (e.g., EDGE) or those using the app offline for an extended period of time might also notice that it takes longer for the app to sync than usual.

Time entries created in the mobile app that have not yet synced with our servers will have a grey exclamation mark. Time entries that have failed to sync will have a red exclamation mark next to them.


Trigger sync manually

While the app is designed to sync automatically when you open it (assuming it has been in the background for more than 5 minutes), you can also trigger sync manually. To trigger sync manually you simply need to pull down on your screen while on the timer page. You will see a loading circle while the app is syncing your data.

Reaching out to support

If the above doesn't help or it just helps briefly and the issue re-appears after a short while please reach out to our support team for further assistance. It's best to use the in-app feedback form if possible so that we can get some useful information along with your message. 

If your app is completely offline and you are not able to use the feedback form please specify in your message the make and model of your mobile device, the OS it's running, and the version of the app that is installed on your phone. 

To see which version of the Toggl app is on your phone tap on the cogwheel icon to access the settings page where you will be able to find that information.

Common sync issues: The web app

The web app via your browser is actually the "most direct link" you can have with our servers and it's really rare to see a syncing-related error there but it can happen and it usually happens due to actual connection issues that may be caused by network restrictions as described above for the desktop app. If the web app is offline you will see the following option to "reconnect":

Keep in mind that this can also happen if you just opened up your laptop, waking it up, and it still hasn't connected to a network. Clicking "reconnect" as soon as you see that your device is online should do the trick in that scenario. 

If any of the time entries you created with the desktop app didn't sync you will see an exclamation mark on the left side of the time entry description. Hovering your mouse over the exclamation mark will give you the option to retry syncing that specific time entry.

If trying different networks, tweaking the network settings for proxy and firewall, refreshing the page or clicking on the "reconnect button" doesn't help please reach out to our support team and we will do our best to assist you.

Did this answer your question?