Document toolboxDocument toolbox

Add worklog

Owned by Tibor Tasi
Last updated: Aug 25, 2021 by Attila Bordás
4 min read


The input fields can be seen at the bottom of the page. These fields are used when adding or editing worklogs.


Issue

The issue(s) to which the worklog will belong. You can add multiple issues and log the same worklog to them. This field is mandatory.


Search and display settings

The setting menu is located to the right of the input field. The field will search Issues primarily and displays Issues on the top section based on the chosen setting. If there is no match, it looks for all (user-accessible) Issues according to the keywords.

You can choose here from the following:

  • Recent Issues: The Issues that the current user recently viewed.
  • Recently Worked On: The Issues for which the user has recently logged work.
  • Assigned: The Issues for which the user is assigned.
  • Watched: The Issues that the user is watching.

You can also include or exclude Issue with "Done" category status in the search with the following filter options:

  • Exclude Closed Issues
  • Include Closed Issues

Select Issue

The field can be filled in three ways:

  • Typing the issue code(s) or summary in the field. The autocomplete function will display the issues matching the typed text.
  • By clicking on the arrow, the users can select one of the issues from the list. The list will show Issues according to the picker settings.
  • Navigating to Timetracker from an Issue page. In this case, Timetracker will load the IssueKey from that Issue view screen.

Issues can be removed from the input field by clicking on the X next to them.


Detailed Time tracking mode

Start Time

Start time of the worklog. This field is mandatory.

You can use the "Now" button to:

  1. Pressing the Now button (clock icon) once will set the current time as a value. 
  2. Pressing the Now button again will round the time first up then down with 5 minutes.

End Time / Duration

End time of the worklog. The value of the end time cannot be smaller than the start time. It is optional, but either the End time or the Duration field has to be filled in.

By default, its value is the current time.

You can use the "Now" button to:

  • Pressing the Now button (clock icon) once will set the current time as a value. 
  • Pressing the Now button again will round the time first up then down with 5 minutes.


Simple Time tracking mode

Duration

Duration of the worklog. The value cannot exceed the value of 24:00 minus the Start Time. It is mandatory.

Its format: hh:mm or Xh XXm. 


Description

The worklog description can be given in the note field. The note input field handles the text formatting annotations. The available toolbar appears on JIRA 6.4.x or later.

Additional input fields

You can quickly turn the additional input fields on and off with the help of a button in the upper right corner of the input fields. You can also manage these options in the User Settings.

Remaining Estimate

The Timetracker Adjust automatically the Remaining Estimate by default (the estimate will be reduced by the amount of work done). You can choose in Timetracker settings whether you want to display additional Remaining Estimate adjusting options. 

(warning) Timetracker require dot (.) as a decimal separator in case of decimal numbers.

Period

 With the period worklog option, you can administer regular tasks. Worklog will be added for the working days that are included in the period, except for weekends and excluded dates.

  • Enter the data about the regular worklog.
  • Check the period checkbox.
  • Enter the step you want to save the worklog within the period. One step means one day!
  • Enter the desired End Date to log work for each day in the interval (from the actual date until the End Date).

Worklog Attributes

Add pre-defined attributes to your worklogs. Differentiate logged works with labels like "overtime", "not billable", etc.

You can add multiple attributes at once.

Update fields from the worklog table

  • The Issue field can be copied from the Worklog table by clicking on the cell. 
  • The Issue Description field can be copied from the Worklog table by clicking on it. 
  • You can also copy the Start and End time field but in that case, the values will be switched. This can be useful when you want to fill a hole between two worklogs.