Being an online service, Toggl lets you access your account and data via multiple platforms. Currently you can access your Toggl account using 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 where a connection might have some restrictions applied (you might be connected behind a proxy or a firewall) preventing the app from syncing your data or even preventing you from logging into the app.  

In case you have been able to create time entries but the data never synced with our servers the app will be showing exclamation marks next to time entries which failed to sync: 

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

Triggering a sync manually

If you end up in a similar situation, it's best to first try triggering a 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 a 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) are not capable of background syncing at the moment. To make sure your mobile app is up to date it's best to trigger a sync manually after bringing it back into focus and before you close it after your'e done tracking your time for the day. 

If any of the time entries you created with the mobile app failed to sync with our servers they will have an exclamation mark next to them like so: 

As shown in the image above, the top two time entries failed to sync and have an exclamation mark on the right side indicating a syncing issue (same goes for iOS).


Trigger a sync manually

With these situations, it's best to try triggering a sync manually. To trigger a 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. 


Restarting the app

Sometimes if triggering a sync manually doesn't help restarting the app will. Simply close the app on your phone completely and start it up again, sometimes multiple restarts are required. 


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 what version of the app 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 and 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?