Log time on an issue
Record hours spent working on a specific issue.
View time reports
Aggregate and filter time entries by user, project, activity, or period.
Enabling time tracking
Time tracking is a project module. To enable it:- Open the project and go to Settings → Modules.
- Check Time tracking.
- Click Save.
Logging time on an issue
Find the Log time section
Scroll to the Log time section at the bottom of the issue page, or click Log time in the sidebar.
Logging time from the project
You can also log time without opening a specific issue:- Go to Spent time in the project sidebar.
- Click Log time.
- Enter the fields. You can optionally specify the Issue to associate the entry.
Time entry fields
| Field | Required | Description |
|---|---|---|
| Date | Yes | The date the work was performed (spent_on). Defaults to today. |
| Hours | Yes | Time spent in hours. Accepts decimal values (for example, 1.5 for 90 minutes). |
| Activity | Yes | The type of work performed (for example, Development, Design, Testing). Activities are defined by administrators. |
| Comment | Configurable | A brief note describing what was done. Maximum 1024 characters. |
| Issue | Configurable | Associates the entry with a specific issue. May be required depending on system settings. |
| User | No | The user who performed the work. Defaults to the logged-in user. Users with the Log time for other users permission can log on behalf of others. |
Administrators can make the Issue and Comment fields required via Administration → Settings → Time tracking.
Activities
Activities categorise the type of work performed. Default activities include Development, Design, and Testing. Administrators manage global activities under Administration → Enumerations → Time tracking activities. Project-level overrides allow a project to use a different set of activities.Viewing time entries
Issue-level spent time
On an issue detail page, the Spent time section shows all time logged directly against the issue. Parent issues also display aggregated totals from all descendant issues (Total spent time).Project time log
Go to Spent time in the project sidebar to see all entries for the project, filterable by various criteria.- List view
- Report view
The default list view shows individual time entries with columns for:
- Date
- User
- Activity
- Issue
- Comment
- Hours
Filtering time entries
The time log supports a rich set of filters:| Filter | Description |
|---|---|
| Period | Predefined ranges: today, this week, last week, this month, last month, this year |
| Date | Custom start and end date |
| User | Filter by one or more team members |
| Activity | Narrow by activity type |
| Issue | Show entries for a specific issue |
| Version | Show entries for issues in a target version |
| Project | When viewing the global time log, filter by project |
Permissions
| Action | Permission required |
|---|---|
| Log time | log_time |
| View time entries | view_time_entries |
| Edit own time entries | edit_own_time_entries |
| Edit all time entries | edit_time_entries |
| Log time for other users | log_time_for_other_users |
