> For the complete documentation index, see [llms.txt](https://teranoapps.gitbook.io/time-tracking-custom-field/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://teranoapps.gitbook.io/time-tracking-custom-field/configuration.md).

# Configuration

This page covers the **ongoing configuration options** available after you have installed the app and created your first fields. If you haven't done that yet, start with the [Getting Started](/time-tracking-custom-field/getting-started.md) guide.

{% hint style="info" %}
All settings on this page require **Jira admin** or **project admin** permissions.
{% endhint %}

***

## Configuring the Duration field

The Duration field has its own configuration panel that lets you control how time values are interpreted and displayed. To open it, go to **Jira settings → Issues → Custom fields**, find your Duration field, and open its configuration.

{% stepper %}
{% step %}
**Set time units**

Configure how the field translates day and week shortcuts:

* **Hours per day** (default: 8) — defines how many hours `1d` represents. For example, if your team works 6-hour days, set this to 6.
* **Days per week** (default: 5) — defines how many days `1w` represents.

These settings affect both input parsing and display formatting.
{% endstep %}

{% step %}
**Choose plain number interpretation**

Decide how the field interprets a plain number (for example, when a user types just `30`):

* **Minutes** (default) — `30` is interpreted as 30 minutes.
* **Hours** — `30` is interpreted as 30 hours.

{% hint style="warning" %}
This setting affects all users of this field. Make sure your team knows whether plain numbers mean minutes or hours.
{% endhint %}
{% endstep %}

{% step %}
**Set whether the field is required**

Toggle the **Required field** switch:

* **Off** (default) — the field can be left empty.
* **On** — users must enter a value; leaving it blank will show a validation error.
  {% endstep %}

{% step %}
**Save**

Click **Save configuration** to apply your changes. The new settings take effect immediately for all users.
{% endstep %}
{% endstepper %}

**Configuration options summary:**

| Setting                     | Default | Range           | Description                              |
| --------------------------- | ------- | --------------- | ---------------------------------------- |
| Hours per day               | 8       | 1–24            | How many hours `1d` represents           |
| Days per week               | 5       | 1–7             | How many days `1w` represents            |
| Plain number interpretation | Minutes | Minutes / Hours | How to interpret a bare number like `30` |
| Required field              | No      | Yes / No        | Whether the field must have a value      |

{% hint style="info" %}
The **Time Tracking** field type does not have a separate configuration panel — it uses the same time-unit settings as Jira's built-in Time Tracking.
{% endhint %}

***

## Advanced configuration

Once your fields are set up and working, these topics cover more advanced admin scenarios.

### Multiple time tracking fields on one issue

If your teams need **separate time buckets** (for example Dev Estimate and QA Estimate) but you still want a **combined total** in Jira's native Time Tracking, configure a **bucket set** to sync them automatically.

{% content-ref url="/pages/WS4xEQOAz1pHE4lzkEJH" %}
[Multiple time tracking fields on one issue](/time-tracking-custom-field/configuration/multiple-time-tracking-fields-on-one-issue.md)
{% endcontent-ref %}

### Require time to be logged (workflow validator)

Add a **workflow validator** that blocks a transition (for example **In Progress → Done**) unless a minimum amount of work has been logged on the issue. Works with Jira's built-in Time Tracking in both company-managed and team-managed projects.

{% content-ref url="/pages/VB1wPX4m4SoPpn8VNbXX" %}
[Require time to be logged (workflow validator)](/time-tracking-custom-field/configuration/require-time-to-be-logged-workflow-validator.md)
{% endcontent-ref %}

***

## Next steps

{% content-ref url="/pages/6LJ2VJ6MbD6ZkDsaDwqS" %}
[Use Time Tracking fields](/time-tracking-custom-field/user-guide/use-time-tracking-fields.md)
{% endcontent-ref %}

{% content-ref url="/pages/9LfENLgpBBif5Na29Onv" %}
[Use Duration fields](/time-tracking-custom-field/user-guide/use-duration-fields.md)
{% endcontent-ref %}

{% content-ref url="/pages/iTN2uwuLQOAEvgN8H4xq" %}
[Search & Reporting](/time-tracking-custom-field/search-and-reporting.md)
{% endcontent-ref %}