# Time Tracking

# Time Tracking

> Time tracking is a **[Pro](https://manual.codecks.io/plans/)** feature. To use it in your organization
> you need to be on a paid Pro plan or be using the free educational plan.

Time Tracking can be enabled via `Organization Settings > Features`. You can pick between two modes:

- Manual
- Real-time and Manual

If time tracking is disabled, no exisiting time tracking information will be lost.

## Manual Time Tracking

In this mode the History side panel of an open Card contains an _Add Time_ button which allows to enter and edit time tracking information. Using the button, you may enter time spent and choose the date and time on which this work happened. The entered time tracking data is always associated with your user account.

![Manual Entry Form](https://manual.codecks.io/_astro/manual-form.BL8ORjCi_Z15l4Ww.webp)

> This form can be quickly opened by hitting `shift + t` while you have a card
> opened, or by `cmd/ctrl + click` on the clock icon in the card header shown
> below.

The history panel also shows previously tracked time. You can correct the tracked time by using the plus/minus buttons next to the time entry to add or remove time in 5 minutes steps (\*spent too long at the coffee machine?).
You can also click on the time entry itself for an input field offering more extensive editing. You can delete the full time tracking entry by clicking the trash icon next to it.

At the top of the Card history panel you'll find a _Total tracked time_ entry summing up all time entries on this Card sorted by owner. There is also a small clock icon at the bottom of each Card containing time information. Hovering over it will allow you to check the total amount of time spent at a glance.

The clock icon contains a colored fill that grows as more time is tracked. The filled area increases exponentially with the total time spent on the card, meaning it provides a quick visual intuition for comparing relative time spent between cards, but the relationship isn't linear (e.g., a half-filled icon doesn't necessarily mean twice the time of a quarter-filled icon). The area approaches being full asymptotically, meaning it would only theoretically reach 100% fill with infinite time spent.

You can also use time tracking information to sort cards. This is a good way for quickly identifying expensive tasks in your Run, Milestone or Deck view.

> **Time Tracking Independence**
>
> We deliberately separated time tracking from card workflow states. This means you can track time while helping on a blocked card, doing a review, or working on something that's technically assigned to someone else.
>
> The old model tied "started" to "timer running," which broke down as soon as multiple people needed to collaborate on one card, or you needed to track meeting time, or you wanted to track review time separately from implementation.
>
> Now the workflow state answers "what phase is this work in?" and time tracking answers "who spent how long on it?" Two different questions with two different tracking mechanisms.

## Real-time tracking

Enabling real-time tracking, includes all features described above for manual time tracking. In addition, the play button in the top bar of every Card doubles as your timer control — it's used to start, stop and inspect the timer.

![Running Tracker for two people on a Card](https://manual.codecks.io/_astro/time-tracking-button.B22EtbeX_7P98Q.webp)

The play button is the single combined entry point for both starting work and tracking time:

- On your own task cards that are not yet started, clicking it sets the Card to _started_ ([blue](https://manual.codecks.io/workflow/#started-cards)) **and** starts your timer in one go. Clicking it a second time only stops the timer; the Card stays in the _started_ state. Use the **…** (More Options) menu on the opened card to _unstart_ it again.
- On Hero Cards and Doc Cards (which don't have a _started_ state), the same button only controls the timer.
- On Cards that are blocked, in review, or owned by someone else, you can still start the timer through this button without changing the Card's workflow state — handy for tracking time you spend reviewing or helping out.
- If you mark a Card as done, your own timer on it is stopped automatically.
- If a _started_ Card stops being started — it gets marked as done or unstarted, a review or block conversation is opened on it, or its owner is changed — all running timers on it are stopped automatically.
- If a Card gets archived or deleted, all running timers on it are stopped automatically.

Cards that are actively being time-tracked show a small **blue timer widget**, no matter whose timer is running. This makes it easy to tell apart cards that have merely been _started_ ([blue](https://manual.codecks.io/workflow/#started-cards)) from cards that someone is actively working on _right now_. It works across the whole team — not just for your own cards — and shows up both on mini cards and in [Table View](https://manual.codecks.io/sorting/#table-view).

Here's some rules around time tracking:

- A single user can only have a single timer running.
- The timer can started on any type of card by any amount of people. This could be useful for e.g. meetings that can be represensented via meeting cards.

Enabling real-time tracking also gives you a handy widget in the bottom left, which highlights your current task and the time spent so far. You can quickly adjust the time spent by using the plus/minus buttons. You can also stop the timer by pressing the stop button on the widget.

In addition the web site title will change so that you can scan the time spent on your browser tab. In case you forget to stop the Card timer you can always manually edit the Card history to fix up the time. In your organization settings you will also find a field to edit the amount of time after which a Card time tracker will stop automatically due to suspiciously effective work segments. If the tracker was automatically stopped, you'll receive a notication and the widget of the bottom will have turned into a snoozing purple color.

A Card's history panel also highlights these entries with a snoozing icons until the time entries have been adapted.

> #### Started Worflow State vs Running Timer
>
> The _started_ workflow state and the running timer are two independent pieces of information. You can have multiple cards marked as _started_ at once, the timer can run without the card being _started_ (e.g. while you help out on someone else's task), and several team members can each track time on the same Card in parallel — useful for meetings or reviews.
>
> The play button is the convenient front-end that ties these two actions together for the common case of "I am now actively working on my own Card": the first click on a not-yet-started task card sets it to _started_ and starts your timer in one go. Beyond that, the button only stops or starts the timer; use the **…** menu on the opened Card to _unstart_ it.
>
> This separation highlights potential process issues: if a single person — or the whole team — has many cards marked _started_ but no movement toward review or done, it usually signals that the team is taking on too much in parallel.

## Time Tracking Report

You can access the time tracking report via the mission control (open by clicking on the joystick in the top left). The report contains a detailed list of all time tracked by all team members.

You can sort by:

- Date
- Duration
- User
- Card
- Deck
- Project

To filter the table use the filter icons next to the individual table columns to show/hide individual entries. You can filter by date, user and project. The date filter starts out showing the last 28 days, including today.
Below the table you can see the total time tracked within the current filter, along with the total for each user.

You can export all entries for your current filter in CSV format by clicking the export button next to the total.
