> 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/user-guide.md).

# User Guide

{% hint style="info" %}
**Before you start:** the app's fields only appear on issues if they have been configured by an admin.

To see and use these fields, your Jira admin must:

* install **Time Tracking Customfield** from Atlassian Marketplace,
* create one or more custom fields of type **Time Tracking** or **Duration** (for example "QA Estimate", "SLA Limit"),
* add these fields to the relevant screens (Create, View/Edit, and optionally transition screens and portals) for your projects.

For admin-level details, see the [Getting Started](/time-tracking-custom-field/getting-started.md) and [Configuration](/time-tracking-custom-field/configuration.md) pages.
{% endhint %}

***

## Use Time Tracking fields

* What a Time Tracking field is and how it differs from a normal custom field.
* Where you can see it (Create Issue, View/Edit, transitions, portals).
* How to enter and update time using Jira-style duration strings (for example `30m`, `2h`, `1d 3h`).

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

***

## Use Duration fields

* What a Duration field is and how it differs from a Time Tracking field.
* Where you can see it (Create Issue, View/Edit, transitions, portals).
* How to enter duration values and how auto-normalization works.

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

***

## Timer

* Track time as it happens with a built-in **Start / Stop** timer on every Time Tracking field.
* Stop opens the standard Log work modal pre-filled with elapsed time.
* Timers persist across browser tabs, devices, and reloads.

{% content-ref url="<https://github.com/mivchal333/time-tracking-customfield/blob/main/docs/user-guide/timer.md>" %}
<https://github.com/mivchal333/time-tracking-customfield/blob/main/docs/user-guide/timer.md>
{% endcontent-ref %}

***

## Timesheet — My week

* Review and log a whole week of time in one **issue × day grid** (Apps → Timesheet).
* Native Jira worklogs and Time Tracking field worklogs side by side, merged.
* Add, edit, and delete entries, and add any issue as a new row.

{% content-ref url="/pages/XOdGoJCIykInrsyhVEKz" %}
[Timesheet — My week](/time-tracking-custom-field/user-guide/timesheet.md)
{% endcontent-ref %}

***

## Looking for admin topics?

If you need to configure **bucket sets** (syncing multiple Time Tracking fields to Jira's native Time Tracking) or set up the **workflow validator** (requiring time to be logged before a transition), see the [Configuration](/time-tracking-custom-field/configuration.md) section.

{% content-ref url="/pages/6w425lHclRfD32iGma1n" %}
[Configuration](/time-tracking-custom-field/configuration.md)
{% endcontent-ref %}