---
title: "Configuring Time Tracking App"
slug: "configuring-hours-app"
updated: 2026-04-27T15:29:15Z
published: 2026-04-30T10:00:01Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.encodify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring Time Tracking App

## Bulk Copy Overview

---

The **Time Tracking** (formerly known as **Hours App**) is a dedicated extension designed for seamless time tracking and management. It operates through six core modules: projects, jobs, tasks, work logs, users and teams, ensuring precise and organised time entry. However, the app is flexible and can be reused within any configuration to fit your specific time management needs.

## Configuring the Project Module

---

Before configuring the app, you will need to create several modules. Follow these steps to create a project-level module:

1. Navigate to **Site Configuration → Site Configuration → Modules**.
2. Click **Create Module**.
3. Set the **Type** to **Module**.
4. Specify a **Name** for the module (e.g., *Briefs*).
5. Select a **Template** (e.g., With Preconfigured *Media Settings and Audit Fields*).
6. Click **OK** to confirm the module creation.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-briefs-module.png)

An image highlighting the creation of a project-level module named ‘Briefs’

1. Navigate to **Site Configuration → {Module} → Field Definition**.
2. Click **New Field**.
3. Enter a **Field Name**. (*e.g. Brief Title*)
4. Ensure the **Field Type** dropdown is set to **Text Field**.
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-brief-title.png)

## Configuring the Jobs Module

---

Next, you will need to configure the *Jobs*module, but follow the steps below:

1. Navigate to **Site Configuration → Site Configuration → Modules**.
2. Click **Create Module**.
3. Set the **Type** to **Module**.
4. Specify a **Name** for the module (e.g., *Jobs*).
5. Select a **Template** (e.g., With Preconfigured *Media Settings and Audit Fields*).
6. Click **OK** to confirm the module creation.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-jobs-module.png)

An image highlighting the creation of Job level module

1. Navigate to **Site Configuration → {Module} → Field Definition**.
2. Click **New Field**.
3. Enter a **Field Name** (*e.g. Briefs*).
4. Select **Module** from the **Field Content** dropdown.
5. In the **Field Type** dropdown, select **Select Box.**
6. Locate the **Module** field and select the **Projects** module previously created
7. Within the **Module Field** dropdown, select the Text Field previously created to define Brief Title.
8. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-brief-title-module-link.png)

1. Navigate to **Site Configuration → {Module} → Field Definition**.
2. Click **New Field**.
3. Enter a **Field Name**. *(e.g. Job Name)*
4. Ensure the **Field Type** dropdown is set to **Text Field**.
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-job-name-field.png)

1. Click **New Field**.
2. Enter a **Field Name**. *(e.g. Is Admin Job)*
3. Ensure the **Field Type** dropdown is set to **Select Box**.
4. Locate **Create,**and add a single option labelled Yes
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-is-admin-job.png)

## Configuring the Task Module

---

Next, you will need to configure the *Task* module, but follow the steps below:

1. Navigate to **Site Configuration → Site Configuration → Modules**.
2. Click **Create Module**.
3. Set the **Type** to **Module**.
4. Specify a **Name** for the module (e.g., *Tasks*).
5. Select a **Template** (e.g., With Preconfigured *Media Settings and Audit Fields*).
6. Click **OK** to confirm the module creation.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-tasks-module.png)

An image highlighting the creation of Task level module

1. Navigate to **Site Configuration → {Module} → Field Definition**.
2. Click **New Field**.
3. Enter a **Field Name**. *(e.g. Task Name)*
4. Ensure the **Field Type** dropdown is set to **Text Field**.
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-task-field.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Briefs*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Projects** module previously created
6. Within the **Module Field** dropdown, select the Text Field previously created to define Brief Title
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.51.24.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Jobs*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Jobs** module previously created
6. Within the **Module Field** dropdown, select the Text Field previously created to define Job Name.
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-job-name-in-tasks(1).png)

## Configuring the Worklog Module

---

Next, you will need to configure the *Worklog* module by following the steps below:

1. Navigate to **Site Configuration → Site Configuration → Modules**.
2. Click **Create Module**.
3. Set the **Type** to **Module**.
4. Specify a **Name** for the module (e.g., *Tasks*).
5. Select a **Template** (e.g., With Preconfigured *Media Settings and Audit Fields*).
6. Click **OK** to confirm the module creation.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-worklog-module.png)

An image highlighting the creation of Worklog module

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Projects*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Projects** module previously created
6. Within the **Module Field** dropdown, select the Text Field previously created to define Project Name
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.51.24(1).png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Jobs*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Jobs** module previously created
6. Within the **Module Field** dropdown, select the Text Field previously created to define Job Name.
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.53.20.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Tasks*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Tasks** module previously created
6. Within the **Module Field** dropdown, select the Text Field previously created to define Tasks.
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.07.32.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Worker*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Users** module
6. Within the **Module Field** dropdown, select the Text Field previously created to define Name.
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.55.30.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Start Date*).
3. In the **Field Content** dropdown, select **Date.**
4. Locate the **Skeleton** field, and define the specific date format option.
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.56.35.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Duration*).
3. In the **Field Content** dropdown, select **Integer.**
4. Locate the **Duration Enabled** field and ensure it is **checked**.
5. In the **Duration View As** dropdown, select **Hour**.
6. In the **Duration Round Up To** dropdown, choose the desired rounding behaviour.
7. In the **Duration Hours in Day** field, specify the default working hours per day.
8. In the **Duration Days in Week** field, specify the default working days per week.
9. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.58.12.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Timer Started At)*
3. In the **Field Content** dropdown, select **Date.**
4. Locate the **Skeleton** field, and define the specific date format option.
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.58.55.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Timer Ended At)*
3. In the **Field Content** dropdown, select **Date.**
4. Locate the **Skeleton** field, and define the specific date format option.
5. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 17.59.24.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Is running*).
3. In the **Field Content** dropdown, select **Integer.**
4. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.00.12.png)

## Configuring the Teams Module

---

Next, you will need to configure the Teams Module, but follow the steps below:

1. Navigate to **Site Configuration → Site Configuration → Modules**.
2. Click **Create Module**.
3. Set the **Type** to **Module**.
4. Specify a **Name** for the module (e.g., *Departments*).
5. Select a **Template** (e.g., With Preconfigured *Media Settings and Audit Fields*).
6. Click **OK** to confirm the module creation.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/create-teams-module.png)

An image highlighting the Team module named ‘Departments’

1. Click **New Field**.
2. Enter a **Field Name**. *(e.g. Department)*
3. Ensure the **Field Type** dropdown is set to **Text Field**.
4. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.01.09.png)

## Configuring the Users Module

---

Next, you will need to configure the Users Module, but follow the steps below:

1. Navigate to **Site Configuration → Users Configuration → Field Definition**
2. Click **New Field**.
3. Enter a **Field Name**. *(e.g. Is Line Manager)*
4. Ensure the **Field Type** dropdown is set to **Select Box**.
5. Locate **Create** and add two options to the dropdown: **Yes** and **No**
6. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.02.23.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Line Managers*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Users** module previously created
6. Within the **Module Field** dropdown, select the Text Field that defines users fu’s full name
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.03.53.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Working Hours*).
3. In the **Field Content** dropdown, select **Integer.**
4. In the **Default Text**, specify **8.**
5. Locate the **Duration Enabled** field and ensure it is **checked**.
6. In the **Duration View As** dropdown, select **Hour**.
7. In the **Duration Round Up To** dropdown, choose the desired rounding behaviour.
8. In the **Duration Hours in Day** field, specify the default working hours per day.
9. In the **Duration Days in Week** field, specify the default working days per week.
10. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.02.42.png)

1. Click **New Field**.
2. Enter a **Field Name** (*e.g. Main Department*).
3. Select **Module** from the **Field Content** dropdown.
4. In the **Field Type** dropdown, select **Select Box.**
5. Locate the **Module** field and select the **Department** module previously created
6. Within the **Module Field** dropdown, select the Text Field that defines Department
7. Click **OK** to create the field.

![](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-04-03 at 18.02.55.png)

## Configuring the Time Tracking App

---

To enable the app, follow these steps:

1. Navigate to **Configuration → Apps Library**from the sidebar.
2. Locate the **Time Tracking**/ **Hours App** and click the card.
3. The app **Name** will be pre-filled with ‘Hours’. Adjust to your requirements.
4. Specify whether you wish to **Enable Name Concatenation**. This option allows you to display more context about the project, job and task level within the Hours App.
5. Navigate through each configuration option, ensuring to select the fields previously created.
6. Click **Create** to confirm settings.

![Hours App configuration page](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/HoursApp config.png)

**Record Time tab***(available from version 23)*

It is possible to configure the desired behaviour for both **Add Time Entry** and **Start Timer** from the **Record Time** tab. An admin user can define whether the form should open when adding a new time entry or if the form should be bypassed and the time instantly recorded. It is also possible to define at which module levels **Add Time Entry** and **Start Timer** are available to users. By default, the settings are configured to always open the form, display **Add Time Entry** in all module levels, and make **Start Timer** visible only at the Task level.

**Note**: When configuring the option *“Open if there are required field”* is referring to fields in the **Worklog**module.

![Hours App configuration, Record Time tab](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Record Time tab.png)

---

## Configuring Estimation Field

The **Estimation** field represents the amount of time expected to complete a work item. It is used to compare planned effort with the actual time logged (**Time Spent**). It will display the total time considering all the time logged in that item, considering all users involved. The **Estimation** field can be enabled at the **Project, Job, and Task levels**.

#### Part 1: Creating New Field Definitions for Estimation

*(in Project, Job, and Task modules)*

1. Navigate to **Site Configuration → Task → Field Definition**
2. Click **New Field**
3. Enter a field name (e.g. *Estimation*)
4. In the Field Content dropdown, select **Integer**
5. Locate the **Duration Enabled** option and ensure it is checked
6. In the Duration View As dropdown, select **Hour**
7. In the Duration Round Up To dropdown, choose the desired rounding behaviour
8. In the Duration Hours in Day field, specify the default working hours per day
9. In the Duration Days in Week field, specify the default working days per week
10. Click **OK** to create the field

***Note:****This example applies to the Task module. Repeat the same steps for the Job and Project modules if needed.*

![Form fields for estimation with options for duration enabled](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Estimation field.png)

#### **Part 2: Adding the Field to Module and Item Views**

Add the newly created **Estimation** field to the relevant module and item views.

See here [how to configure Module and Item views](/v1/docs/item-views)

#### **Part 3: Configuring the Time Tracking (Hours) App**

Navigate to the corresponding module in the **Time Tracking (Hours) app configuration** (e.g. Project), then scroll down to the **“Project – Optional”** section.

Select the newly created **Estimation** field from the dropdown and **save the configuration**.

![Configuring Estimation field in Time Tracking App config](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Add estimation field in Time Tracking App config(2).png)

#### **Part 4: Setting Estimation Values**

1. Navigate to the **Project, Job, or Task module**
2. Open an existing item
3. Enter a value in the **Estimation** field (e.g. *40h*) and save the item

Once configured, the **Timesheets popover** and **Log Time Callout** will display the estimated hours for the item.

For more details about comparing **Time Spent vs Estimation**, see [Time Spent and Estimation](/v1/docs/time-spent-and-estimation#viewing-time-details-in-timesheets).

---

#### Known behaviour

- A user should have at least "Read" access to the Project, Job, Task and Work Log modules specified within the app configuration.
- A user should have "Read" + "Upload" access to the Work log module to be able to add time registration in the app.
- A user without "Delete" access to the Work log module can delete already existing work log entries.
- Status access restrictions are ignored in the Work log module if configured.
- Date picker respects the browser locale settings.
- The "Timer started at", "Timer ended at", and "Is running" fields from the Worklog module should be displayed on the form. In case hidden by field usage, the timer functionality will not work.
- The following Duration field settings are currently not supported in the app when entering worklog:
  - Duration. Hours in day
  - Duration. Days in week