Skip to content

Desktop App: everyday questions

This article answers the everyday questions about the WebWork Desktop App: where the timer is, how the tray icon works, and how starting, switching tasks, breaks, offline work, updates and signing out behave. For a tour of the app, see Desktop App Overview. For every setting of the app, see Settings in Desktop Tracker.

Where is the timer, and what does it show?

The timer sits at the top of the main window and stays there on every tab. It shows the project and task you track, the field What are you doing now?, the time, the Start or Stop button, and a coffee-cup button for breaks when your workspace uses breaks.

  • The big time is today’s time on the selected project, not your total for the day, and it changes when you switch projects. Your day’s total across all projects is Today on the Overview tab.
  • The seconds show only while the timer runs.
  • Clicking the project name on the timer opens the Projects and tasks tab.
  • The app has no keyboard shortcut for Start or Stop.

Use Overview for your daily total and Projects and tasks to change what you track. Click your avatar for account actions.

Closing the window hides it: the app keeps running, and tracking, from its tray or menu bar icon. To close the app, click Quit in the avatar menu or in the icon’s menu. Opening the app while it already runs brings its window to the front.

How does the tray or menu bar icon work?

On Windows and macOS:

  • Click the icon once to open the mini tracker.
  • Double-click it to open the main window.
  • Right-click it for its menu.

Use the mini tracker to select a project and task, start or stop tracking, or start a break.

The icon’s menu holds Start, Stop, Open, Refresh, Show as, Sign out and Quit. Linux has no Show as. Show as decides what the icon shows:

Show asWhat you see
Tray iconThe icon alone. This is the default.
Floating widget on Windows 11, Taskbar widget on older Windows and on macOSThe time as well. On macOS it sits next to the menu bar icon.

The icon changes while the timer runs and during a break.

How do I start and stop the timer?

Click Start on the timer to track the project and task you used last. To track something else, start it from its task, as the next section shows.

Three workspace settings change this. Tracking Settings covers them.

  • Under Settings > Tracking > General, Who should control when tracking starts and stops? has two choices: Members control it and Automatic tracking. With Automatic tracking, the timer starts by itself. The Start or Stop button is greyed out, and hovering it shows “In automatic mode, time tracking runs continuously and cannot be paused.” Start and Stop in the icon’s menu are greyed out too.
    Who should control when tracking starts and stops, with the choices Members control it and Automatic tracking
  • Auto start, under Settings > Tracking > Desktop Software, starts the timer each time the app opens. It cannot be turned off while tracking is automatic.
  • When Allow time tracking without a task, under Settings > Tracking > Advanced, is off, the no task row is gone, and starting without a task shows Can’t track without a task.

When the timer cannot start, a message under it says why: No Contract, Contract paused, Contract limit over, User limit over, Workspace is suspended, Idle dialog is active, Can’t track without a task or Invalid base timestamp. For a timer that stops during the day, see Why does my WebWork tracker stop by itself?

How do I switch project and task?

  1. In the main window, open Projects and tasks.
  2. Click the project to list its tasks.
  3. Click the start (play) button on the task, or on no task.

When the timer is stopped, clicking a project selects it. While the timer runs, clicking a project only lists its tasks, and starting another task switches to it without stopping the timer. With Members control it, click the running task’s Stop button to stop the timer.

In the mini tracker, choosing a project in Select project switches to it at once; then choose the task in Select Task. Projects and Tasks in Desktop Tracker covers no task and Project time details.

What does “Contract paused” under the timer mean?

The app has no project selected that it can track on. Despite its name, this message does not mean someone paused your contract. Select a project to clear it:

  1. In the main window, open Projects and tasks.
  2. Click a project to list its tasks.
  3. Click the start (play) button on a task, or on no task.

A paused or unassigned contract works differently: the project leaves your project list the next time the app refreshes it. If it was your current project, the timer stops and the app selects another one. If no project is left, the timer shows No Contract, unless your workspace allows tracking without a project; then the app selects No project.

If Tracking offline shows, reconnect first. Then click your avatar and click Refresh Data to update your project list. If the project you need is still missing, ask your Workspace Owner or a manager to resume or assign your contract on it.

How do I find or add a task?

Search project filters the project list, and Search task filters the tasks of the selected project. Both match any part of the name, in upper or lower case. Each task shows its name, its due date, marked when overdue, and your time on it this week.

Add task shows only on the projects where you may create tasks:

RoleMay create tasks
Owner, Executive Managers and Team ManagersAlways
Project ManagerOn the projects they manage
Project ViewerOn their projects, once Enable paid collaboration is on
Regular UserWhen the Owner turns on Allow editing tasks by regular users or Allow regular users to see, create, edit, and delete tasks for others, under Settings > Tasks > Permissions
  1. In Projects and tasks, click the project.
  2. Click Add task, under the task list.
  3. Type the task’s name.
  4. Click the check mark.

The task appears once the list refreshes.

After the Owner changes the permission, Add task can take up to 15 minutes to appear. Then click Refresh Data in the avatar menu.

How do I take a break?

  1. Click the coffee-cup button next to the timer, or Start Break in the mini tracker.
  2. Choose a break type. Each type shows the time left, such as “45m left from allowed 1h break”, and a type with no time left is greyed out.
  3. Click Start break.

A break stops the work timer. The timer shows Break Tracking, the break type and a line such as “Daily limit of this break is 1h”. Breaks of 24 hours or more show no limit line.

To end the break and go back to work, click the button in the place of Start and Stop, which shows a break icon during a break. The work timer starts again on your last project and task. Stop in the icon’s menu ends the break without starting the work timer.

When the break’s daily limit is used up, the break ends by itself. Time to finish break says “The limit of [break] is up for today. Time to go back to work.”, and Got it starts the work timer.

  • A break never records more than the time left on its limit, even if the computer slept during it.
  • If your workspace turns breaks off during your break, the break ends.

Break Tracking covers breaks after idle time, and How to create Break Policies? covers the break types and their limits.

What happens when I work offline?

The app keeps tracking without internet and saves everything on the computer, as Offline Time Tracking describes. While offline, the timer shows Tracking offline. Hovering it shows “We save your data when tracking offline and will sync it when connection is restored. Please don’t log out or change the workspace.”

  • Sending does not start the moment the connection returns. The app sends at its next upload, within about 9 minutes while the timer runs, or at once when you click Stop.
  • Screenshots taken offline wait on the computer for up to one week. A screenshot not sent within a week is deleted.
  • Quitting the app or restarting the computer keeps the saved time on the computer. It is sent the next time you track: about 4 minutes after Start, or when you click Stop.

Once you are online, click Stop before quitting to send your saved time. Check that it appears in the dashboard before signing out.

Signing out while offline deletes the time that was not sent. As the app’s message says, do not sign out or change the workspace until the connection is back.

Screenshots that were not sent stay on the computer through a sign-out and are sent after you sign in again. Keep cleanup apps from deleting WebWork data names the folder that holds the unsent data.

Does the app open with my computer?

Autorun, in the app’s Settings under App settings, opens the app when you sign in to your computer. It is on by default on Windows, macOS and Linux. On macOS it adds the app to your Login Items.

  • Autorun only opens the app. The timer starts by itself only with Auto start or Automatic tracking; otherwise click Start.
  • With Automatic tracking, Autorun is hidden in the app and always on. On Windows and Linux the app then opens hidden, in the tray, at sign-in.

Remind me to turn the tracker on, under Reminders in the app’s Settings, offers Disabled, 5 min, 10 min, 30 min, 60 min, 90 min and 120 min. After you stop the timer and that time passes, the app asks Start the tracker?, and Yes starts it. If you have shifts, the reminder appears during your shift hours. Closing the reminder with its close button schedules another reminder after the selected interval.

How do I update the app?

The Overview tab shows your version, such as “Version 6.16.10”. When a newer one exists, it shows Update with “to get the latest tracker version.”; otherwise it shows Latest Version. Update opens the update page, and so does Check for Updates in the avatar menu. How to update or reinstall the Desktop App? covers the update itself.

Auto-update, in the app’s Settings, is off by default. When it is on, the app checks about two minutes after it opens. Turning Auto-update on also schedules a check about two minutes later. If a newer version exists, the app downloads it, asks to install it and then restarts by itself. The install asks for permission:

SystemWhat the install asks for
WindowsAn administrator prompt
macOSYour computer password, in a Tracker New Version Auto-Update Started window with Install and Cancel
LinuxYour password

An app left open for days does not check again. To get an update through Auto-update, quit and reopen the app.

How do I sign out or switch workspace?

Sign out is in the avatar menu and in the icon’s menu, and it asks for no confirmation. Signing out stops the timer and tries to send saved time and screenshots. It then removes local time entries, including any that were not sent. Unsent screenshots stay on the computer until uploaded or expired. Quit closes the app without signing out. For sessions on your other devices, see Can I use WebWork on several devices?

If you belong to several workspaces, switch between them in the avatar menu:

  1. Click your avatar.
  2. Hover the top row, which shows your name and the current workspace, to open Switch your workspace.
  3. Click another workspace.

You track in one workspace at a time. Switching stops the timer and tries to send saved time, with no confirmation. If the timer does not start automatically in the new workspace, click Start.

Which day is “today” in the app?

The app’s “today” and “this week” follow your workspace’s time zone, not your computer’s. The Overview and Shifts tabs show it as System time zone:. The Owner sets it under Settings > Workspace, in System Timezone, as Workspace’s System Timezone shows; without one, the workspace uses UTC.

At midnight in that time zone, the app sends your time and starts the new day’s count. A running timer keeps running.

Still having issues?

  1. Update the Desktop App to the latest version, as How to update or reinstall the Desktop App? shows.
  2. Send the error log: click your avatar, then Send Log. How to send error logs? shows the steps.
  3. Contact support with the version shown on the Overview tab, your operating system and what you did before the problem appeared. Customer Support in the avatar menu opens the Support page of the web app, and How to contact WebWork support? lists the other ways.

Was this article helpful?