# Time Tracking

{% embed url="<https://youtu.be/ayIofv4KqwQ>" %}

The **Time Tracking** feature in Agency Handy allows users to efficiently log work hours, track billable and non-billable time, and manage expense reports. This tool is designed for precise financial insights, automated time logging, and real-time expense calculations for improved project and cost management.

### Goals

* Enable real-time and manual time tracking for tasks.
* Enhance visibility with work logs and team-wide timesheets.

### Pre-conditions

**Permissions Required:** Superadmins, Admins, and Managers have full access. Regular users can only log time on tasks they are assigned to.

**Workspace Setup:** The workspace must be configured with appropriate **Task Assignments** and **User Roles**.

***

### Table of Contents

1. [Accessing Time Tracking](#id-1.-accessing-time-tracking)
2. [Using the Task-Based Time Tracker](#id-2.-using-the-task-based-time-tracker)
3. [Managing Work Logs](#id-3.-managing-work-logs)
4. [Generating Timesheets](#id-4.-generating-timesheets)
5. [Important Notes](#id-6.-important-note)

***

### 1. Accessing Time Tracking

1. Log in to your **Agency Handy** account.
2. Navigate to **Orders → Tasks**.
3. Click on **Time Tracking** under Task Management in the top right corner.

<figure><img src="/files/Eb3PvD3MkNwxsENSSvcS" alt=""><figcaption></figcaption></figure>

📌 *Only Admins and Superadmins can see team-wide time logs.*

***

### 2. Using the Task-Based Time Tracker

Start Time Tracking:

* Go to a specific task under **Orders → Tasks**.
* Click **Start Timer** to begin tracking your time.
* The timer displays:

  * Real-time tracking
  * Task Name
  * Total Time Logged

  <figure><img src="/files/z7owSwRR20LJvoVINJjg" alt=""><figcaption></figcaption></figure>

💡 *You can only have one active timer at a time. Starting a new timer automatically pauses the existing one.*

***

Pause, Resume, and Stop:

* Click **Pause Timer** to temporarily stop tracking.
* Click **Resume Timer** to continue.
* Click **Stop Timer** to finalize the log:

  * Date
  * Start Time and End Time
  * Total Duration
  * Notes (Optional)

  <figure><img src="/files/0jrdYasI4ZfiScyRknPL" alt=""><figcaption></figcaption></figure>

⚠️ *If the task is marked as 'Done,' the timer will be disabled. If reopened, it can be started again.*

***

#### Manual Time Entry:

* Navigate to the task and click **Manual Time Entry**.

* Enter:

  * Date
  * Start Time & End Time
  * Notes (Optional)

  <figure><img src="/files/w9xq112SAmAsis7ajBco" alt=""><figcaption></figcaption></figure>

* For Input Manual Duration\
  Enter:

  * Duration:  Hours & Minutes
  * Date
  * Notes (Optional)

  <figure><img src="/files/zo2wcf3KEkja3biTVQNv" alt=""><figcaption></figcaption></figure>

💡 *Multiple users can log time on the same task simultaneously.*&#x20;

***

### 3. Managing Work Logs

* Click the **Work Log** button beside the timer.
* View the breakdown:

  * Date
  * Start Time
  * End Time
  * Total Time Spent/ Active Time
  * Notes

  <figure><img src="/files/N8u8zaPzdO4smXlmAbaB" alt=""><figcaption></figcaption></figure>

📌 *Admins and Superadmins can delete any time entry. Users can delete only their own.*

***

### 4. Generating Timesheets

1. Navigate to **Timesheets** from the left column.
2. Filter and Search options available:
   * By Task Name
   * By Order ID
   * By Assignee
   * By Date Range (Daily, Weekly, Monthly)\
     \ <br>

     <figure><img src="/files/Mut2LStBpRufrLlaRuzZ" alt=""><figcaption></figcaption></figure>
3. Group By options available:
   * By Team Member
   * By Service Name
   * By Task Name\ <br>

     <figure><img src="/files/3Xtgi3UquJyZJ9FkXiXF" alt=""><figcaption></figcaption></figure>
4. Can entry time:
   * By Start Timer: \
     \- Click the button, and a form will appear. \
     \- From here, you select the Order and task, and give a note. \
     \- Then click the Start button.<br>

     <figure><img src="/files/wA8k0V6L78muaDLAbQO9" alt=""><figcaption></figcaption></figure>
   * By Manual Entry: \
     \- Click the button, and a form will appear. \
     \- From here, you select the Start & End time, Order, and task, and give a note. \
     \- Then click the Save button.<br>

     <figure><img src="/files/fdMCYjSaX1rADdetwUFS" alt=""><figcaption><p>Normal manual Time Entry<br><br></p></figcaption></figure>

     <figure><img src="/files/tQIlrQm4NH3cnBzReno3" alt=""><figcaption><p>Input Manual Duration</p></figcaption></figure>

💡 *Admins and Superadmins can also add manual time entries for users. You can input the Manual Duration in Manual Entry.*

***

### 5. Important Notes

* Running time logs cannot be deleted while active. They must be stopped first.
* Time logs do not create comments on tasks; they are independent of task threads.
* Logs cannot be added to tasks marked as 'Done.' Completed tasks are locked for new entries.
* Superadmins and Admins can manually enter logs on behalf of any user.
* Manual time entries can be added even if an auto time tracker is running.

***

*You have successfully configured Time Tracking in Agency Handy. Your operational management is now more precise and streamlined.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agencyhandy.com/english/agencyhandy-user-guide-for-agency/orders/create-tasks-in-an-order/time-tracking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
