Toggl Track: Hours & Time Log is a native app for iOS designed to help you track time while on the move. It syncs with your Toggl Track account allowing you to seamlessly switch between tracking time on the phone and tracking on the web or desktop.

It is a companion app hence more complex actions like setting up or editing your data structure; using advanced reporting tools etc are accessible via Toggl Track’s web app.

This article covers:

  • Signing up and Logging in

  • Understanding the Toggl Track mobile app

  • Timer screen

  • Creating Time Entries

  • Editing Time Entries

  • Creating Projects, Clients, and Tags

  • Calendar View

  • Reports

  • Settings

  • Widgets and more

Signing up and Logging in

On opening the app for the first time, you will be prompted to create a new account. If you already have a Track account, you can opt to log in using the same credentials. If you forgot the password, use the password reset page to regain access to the account.

A Google account can be used for signing up or logging in if you've already enabled Google login. If you have an existing Toggl Track account but can't sign in with Google, please check whether Google sign-in is enabled by opening the Profile page in the web app. For more details on Google sign-in, open this article.

If your company has enabled SSO login for you, you can use that to log into the mobile app. Currently, we do not support Apple ID login on our Android mobile app.

Understanding the Toggl Track mobile app

The Track mobile app has four main areas:

  • Timer screen: List-view and Pomodoro

  • Calendar view

  • Reports

  • Settings

The navigation bar at the bottom allows you to move between the Timer, Calendar, and Reports screens.

Timer screen

The Timer screen is itself divided into two parts:

  • List View

  • Pomodoro

Timer Screen: List View

List view shows you a list of all your recent time entries. You can also view Track Again suggestions here.

1. Suggestions - a shortlist of your most tracked activities. Tapping an entry will start the timer for that entry.

Note: You can disable the Track Again Suggestions from the Timer screen and from Settings > Timer Defaults.


2. The Time Entry log - a chronological list of your Time Entries, with time entry totals for each date.

If you have grouping enabled, time entries with matching description/task/project combinations will be grouped by each date. You can tap on the grouping to expand it. You can also disable grouping under Settings.

Swipe and Undo

The app comes with two distinct swiping gestures on the Timer Screen. Both can be performed on existing Time Entries:

  • Swipe from right-to-left to delete a time entry

  • Swipe from left-to-right to continue a time entry

After a Time Entry is deleted an undo option appears at the bottom of the screen and is available for 5 seconds, just above the navigation bar.

Note: Please be sure to use the "undo" option before it goes away, there are no other ways of reverting the delete action.

Timer Screen: Pomodoro

Pomodoro is a time management system where you break your tasks down into (usually) 25-minute sprints. This technique was developed by Francesco Cirillo in the late 1980s. Learn more.

Our iOS app has a built-in Pomodoro function. Switch to the Pomodoro tab to get started.

Switch to Pomodoro

The Pomodoro tab allows you to enter time entry details, see the current remaining duration on a session, start and stop the session, switch to full-screen mode and go to Pomodoro Settings.

Main Pomodoro

To start a new session, click on the Start Session button or the "what are you working on?" prompt at the top of the tab. Here you can enter time entry details in the same way as on the List-view screen.

Once a session is started, you can stop a focus session, or skip a break, as needed using the button on the screen. You can also end your Focus session. The screen will display either the current remaining duration or passed time based on whether you have enabled the Countdown Timer or not.

Pomodoro Break and Focus Session

If you prefer to see fewer details, switch to full-screen mode while in focus session. In full-screen mode you can also stop session/skip break or exist full-screen.

Pomodoro Full Screen

Creating Time Entries

You can create new time entries in a few different ways.

To start a new time entry, press the Play button on the bottom-right of the screen. The editing section will slide up, allowing you to add more details to your Time Entry. By default, the timer will start ticking as you create a new entry.

When writing the description, you can use shortcuts to quickly insert Projects or Tags. Use @ to define a Project or # to define a Tag.

To change the duration or start time of your entry tap the running timer in the bottom left area. This will open the Time Selector. Read more about this in the Editing Time Entries section.

When you're finished making changes, remember to tap the Checkmark button in the bottom right corner. Alternatively, tap the X icon in the top left corner to discard all changes.

To continue an existing time entry, press the Play button next to it

To start a manual time entry, click the Mode button on the top-right of the screen.

Manual Mode

To start a Pomodoro session, switch over to Pomodoro and click Start Session. More on Pomodoro in the iOS app here.

You can also use app widgets to start time entries. Read more about these below under the Settings section.

Editing Time Entries

When tapping on a running entry or an existing Time Entry the editing overlay opens up.

If you tap the edit view and swipe up you will reveal more options:

Here you can:

  • Change the duration of the time entry by tapping on the displayed duration (HH:MM) in the middle of the time wheel

  • Change the Start time by tapping on the displayed start time on the left above the wheel

  • Change the Stop time by tapping on the displayed stop time on the right above the wheel

  • Adjust the Start and Stop time by dragging the stop and start icons along the wheel

  • Remove, change or add a project

  • Remove, change or add a tag

  • Mark the time entry as billable or remove the billable status

  • Delete the time entry

  • Click Save to apply the changes

  • Click "X" on the top-left corner to discard the changes

The Time Selector

Accessible when you create or edit an entry, the Time Selector allows you to adjust the duration, start time/date, and end time/date of a time entry.

  • The main wheel in the center is where you adjust the duration. Drag the Play or Stop button back and forth to adjust the Start or End time. This will also update the duration. You can also click on the duration field in the center of this wheel to type in the duration manually.

  • You can click on the Start Time or End Time at the top of the wheel to adjust the time and date manually.

Creating Projects, Clients, and Tags

You can create Projects, Clients, and Tags on the go from the Track mobile app, however, you can only manage these items from the webapp.

  • Projects can be created when the Projects dropdown is open. Click the + Create Project option to do so.

  • While creating a Project, you can also create a new Client. Just click on the + Create Client option in the Client's dropdown. Do note, this option is only available when creating a new project.

  • Tags can be created via the Tags dropdown by clicking + Create Tag.

Note: Tasks can only be created via the webapp.

Calendar View

To access the Calendar tap on the calendar icon on the bottom navigation bar.

The calendar shows existing Time Entries for the current day as colored blocks of time (based on the project color).

Click on an existing entry to reveal an action menu that allows you to delete, edit, or duplicate or continue the selected entry.

By long-pressing on an empty calendar slot, you can create a new Time Entry directly from the Calendar view.

To get the most out of the Calendar feature we recommend integrating one of your calendars with the Toggl Track app. Here's how:

  • Click on the cogwheel icon at the top right-hand corner

  • Click on "Calendar Settings”

  • Toggle the “Allow Calendar Access” option

  • Select the Calendars you want to sync.

Note: You are able to switch Calendar feature off from the same Calendar Settings page.

After you integrate your selected calendar(s) both events in your calendar and your existing Time Entries will be displayed on the Calendar screen. You can click on any Calendar entry to copy it as a time entry, or start a new timer.

Calendar Events

Note: The calendar view allows you to see calendar events from the last 2 months.

Reports

Open Reports by tapping the bar-chart icon from the bottom navigation bar on the Timer screen.

Reports on the mobile app let you see a breakdown of your tracked Projects over a specific period of time.

Note: Mobile reports are limited to your own personal time. For full workspace reports please log into the web app.

Here you can:

  • Change the workspace you're running the report for

  • Go to Settings

  • Adjust the date range

The Reports page shows you (based on your selected date range):

  • Total hours tracked

  • Billable hours and percentage

  • Billable amount

  • A bar graph showing you your time entries across the date range

  • A pie chart (after you scroll down) with a list of all projects and the percentage of time spent on them.

Adjusting the Date Range

By default, when you access Reports you will see data for today and the past 7 days.

Tap on the displayed date range to change it. Use one of the preset date ranges or select a custom date range.

From here you can:

  • Swipe the calendar left or right to browse through the months of the year (You cannot swipe forward if you're on the current month).

  • Tap two different dates to set the start and stop of the reporting period. Tapping on the same date twice will limit the period to one day.

  • At the bottom of the calendar is a horizontal list of presets that let you quickly specify a period of time. Swipe this left or right to look through all the presets, and tap on any of them to apply it.

  • Click Done to save changes

  • Tap outside the popup or click Cancel to exit it.

Note: Reports do not include time entries that are currently running. You can also only select max 365 days at a time.

Settings

The Settings screen can be accessed by clicking on the Settings cog on the Timer or Calendar screens.

Here you can:

Workspace

  • Update the default Workspace

  • Review your plan and next renewal date

Profile

  • Update your name

  • Update your email address

Workspace

Date and Time

Adjust your preferred date and time settings. You can:

  • Choose your date format

  • Switch to 24-hour clock

  • Change the time entry duration format

  • Change the day your week starts

  • Group similar time entries on the Timer screen

Date and Time

Timer Defaults

Here you can manage Pomodoro, and behaviours related to Pomodoro.

You can also enable/disable cell swipe actions and choose to show or hide suggestions.

Timer

Pomodoro Settings

Clicking on Pomodoro Settings under the Timer section opens the Pomodoro Settings page. Here you can customize the length of your Focus and Break sessions, enable/disable sound notifications and change some other settings.


Pomodoro Settings

Focus/Break duration

You can customize how long each Focus and Break period will be. Default options include 10, 25, 55 and 90 minutes for Focus and 5, 10, 15 and 20 minutes for Break. You can also enter a custom duration here.

Auto-Start

You also have access to some other settings for Pomodoro. You can:

  • Auto-start Focus Sessions: When a break ends, the end focus session will start automatically.

  • Auto-start Breaks: When a focus session ends, the break will start automatically.

General

  • Countdown Timer: Counts down the pomodoro session timer instead of counting up.

  • Notifications: Enable/disable pomodoro notifications for when your mobile app is in the background.

  • Prevent Screen Lock: Stop the phone from locking the screen while pomodoro session is ongoing.

Note: Sound notifications will only be triggered if you have auto-start focus sessions or auto-start breaks enabled.

Calendar and Other Settings

Some calendar settings can be adjusted on this screen:

  • Calendar Settings: choose which calendars to pull data from. You will also see any calendar integrations you have enabled in the webapp here.

Calendar

  • Choose which theme (light or dark, or match with OS settings) you prefer.

  • Submit Feedback to our team

  • About: Check the app version, our Privacy Policy, and Term of Service

  • Help: Navigate to this guide and our Support site

Sync Status and Sign Out

Also on the Settings page, you can check the current sync status and log out of the app.

Widgets and More

By long-pressing the Toggl Track app icon a menu is revealed that allows you to:

  • Start a new time entry

  • Go directly to the Reports view

  • Go directly to the Calendar view

  • Send Beta Feedback (TestFlight users)

There are three widget options:

  • Running Time Entry: Shows the currently running time entry

  • Start Time Entry: Allows you to start a new time entry

  • Suggestions: Shows you a few suggested time entries to start again.

Syncing Data with Servers

If your mobile device's Internet connection is solid, data syncing happens automatically even if the app is in the background. From time to time you may notice a rotating wheel indicating that the app is syncing with Toggl Track's servers. You can also check the sync status on the Settings page.

Due to temporary connectivity issues or other factors, syncing issues with mobile apps are, unfortunately, more common than those with the desktop or web app.

To prevent data loss the app notifies you if some of your entries have not been saved to our database with an exclamation mark next to them.

Time Entries that have been marked with !-icons are at the risk of being deleted if the connection isn't restored. If you notice these icons and "syncing failed" error message:

  • Try pulling down on your Timer Screen. We recommend syncing manually as often as possible, for example, every time you either start or stop the timer.

  • If manual sync didn't help and the ! icons are still visible - do not log out of the app as this will cause data loss. Instead, take note of these entries so you'll be able to add them manually later.

  • After you've made sure to back up any un-synced Time Entries from the mobile app, please log out of the app. Logging out clears the app's local data and this is why the previous step is important since we don't want you to lose data.

  • Log back in to see if clearing cache helped with the syncing issues you were having. If the issue persists, please contact our support team.

Here's an article with more information on how syncing between various Toggl Track platforms works.


Frequently Asked Questions

I'm an existing user, why aren't there any entries on my Timer screen?

To keep syncing on mobile as stable as possible the app will pull only data from within 10 days of your last login. You might not see any data in the app if you haven't tracked time for a while. Open Detailed reports in the web app to review your past time entries.

How do I make changes to my projects from the mobile app?

Project management features aren't available in the iOS app. You can create projects, but can't edit them. To edit your projects connect to the Toggl Track web app and visit the Projects page. All your projects can be modified from there.

I don't see my main calendar listed when opening settings to link calendars with the app. Why is that?

Please make sure that the native calendar on your device is linked to the main calendar you use. For example, if you're using the Google Calendar, make sure that your Google account has been set up on your mobile device. By doing so, the native iOS calendar app will have access to your Google Calendars, therefore Toggl Track app will also have access to your Google Calendar.

Why are entries from my calendar not showing up in Toggl Track?

User calendars other than the default are cached by their providers and we can only read from the cache.

Note: In the Google calendar you can force the calendar app to refresh the cache by clicking “Refresh” from the menu in the top right corner.

How is the "Suggestions" section populated?

The "suggestions" section shows you three items you can quickly start time entries from.


It shows:

  • Up to 1 calendar entry for the next closest event,

  • Up to 3 most used time entries.

Need further help with the iOS app? Feel free to contact our support team!

Did this answer your question?