Documentation for JIRA 6.3 EAP developer (EAP) releases only. Not using this? See below:
(JIRA 6.2.x documentation | JIRA OnDemand documentation | earlier versions of JIRA)

Skip to end of metadata
Go to start of metadata

On this page:

About time tracking

Icon

You can only specify time estimates and log work on an issue if your JIRA administrator has granted you the Work On Issues permission in the project to which the issue belongs. Note: Anyone with the Browse Project permission can view an issue's time tracking information.

If an issue (or its sub-tasks) has had work logged and/or an Original Estimate value specified, three coloured bars will be displayed representing the following amounts of time:

  • Original Estimate (blue) — the amount of time originally anticipated to resolve the issue. (This is indicated as Estimated when viewing an issue.)
  • Remaining Estimate (orange) — the remaining amount of time currently anticipated to resolve the issue. (This is indicated as Remaining when viewing an issue.)
  • Time Spent (green) — the amount of time logged working on the issue so far. (This is indicated as Logged when viewing an issue.)

Screenshot: the Time Tracking section of an issue

If your issue has one or more sub-tasks, then:

  • To see aggregated times for your issue plus all of its sub-tasks, ensure that the Include sub-tasks check box is selected.
  • To see times for just your issue only, ensure that the Include sub-tasks check box is cleared.

When you log work on an issue (see below), you:

  1. Log the time you have spent, in weeks/days/hours/minutes (you can use fractions if you wish, e.g. '5.5h').
    (info) This time will be added to the issue's total Time Spent.
  2. Enter a description of the work you have done.
  3. Adjust the Remaining Estimate value (i.e. the remaining amount of time you think the issue will take to resolve).

The work logged on an issue is shown in the Log Work dialog, shown below:

 

Additionally, once work has been logged on an issue, various reports based on the time-tracking information become available.

Specifying time estimates

Prior to logging work on an issue, you may want to specify an Original Estimate for an issue (i.e. the total amount of time you think it will take to resolve the issue).

When work is first logged against the issue, the Time Spent is subtracted from the Original Estimate and the resulting value is automatically presented in the Remaining Estimate. When subsequent work is logged, any Time Spent is subtracted away from the Remaining Estimate.

Throughout the lifecycle of an issue, however, you can modify the Original Estimate and/or Remaining Estimate values manually if you wish. To do this:

  1. Navigate to an existing issue, view it and click the Edit button at the top of the screen to edit that issue.
    OR
    Create a new issue by clicking Create Issue at the top of the screen and complete the required field details.
  2. Edit the following Time Tracking fields:
    • Original Estimate — the amount of time you originally believe is required to resolve the issue. Typically, this is specified when creating an issue or before work is first logged against an issue.
    • Remaining Estimate — the amount of time you believe is required to resolve the issue in its current state.

      Icon

      You may see only one of these fields if JIRA's Time Tracking feature is running in Legacy Mode.

      If JIRA's Time Tracking feature is in Legacy Mode and work has not yet been logged on the issue, you will see the Original Estimate field. However, once work has been logged, you will only see the Remaining Estimate field.

  3. Enter or modify your time tracking details in the Original Estimate and/or Remaining Estimate fields. Use 'w', 'd', 'h' and 'm' to specify weeks, days, hours or minutes. For example, to specify 'six hours', type '6h'.
    (info) If both of these fields are available and are mandatory (indicated by red asterisks), you can just enter one value and leave the other value blank. When you submit the form, the field with a value will be copied to the field that was left blank.
  4. Click Update at the bottom of the screen.
Icon

If you cannot change Original Estimate values on issues after work has been logged on them but you wish to do so, request that your JIRA administrator disables Legacy Mode on Time Tracking.

If your JIRA administrator has added the ability to specify/modify time estimates on other workflow transition screens in JIRA's default workflow (or a d workflow), you will be able to specify/modify time estimates during those workflow transitions too. Additionally, if your JIRA administrator has added this ability to JIRA screens used by other issue types, you can also specify time estimates when creating or editing these types of issues.

Logging work on an issue

Logging work when viewing an issue

To log work when viewing an issue:

  1. Navigate to the issue and view its details.
  2. Select More > Log Work.
  3. The Log Work dialog box is displayed.

    The Log Work Dialog Box
  4. In the Time Spent field, enter the amount of time to be logged. Use 'w', 'd', 'h' and 'm' to specify weeks, days, hours or minutes. For example, to log two hours of work, type '2h'.
    (info) If you type a number without specifying a time unit (e.g. if you type '2' instead of '2h'), the default time unit as specified by your JIRA administrator will apply.
  5. In the Date Started  field, click the calendar icon to select the date/time when you started work. The calendar popup will be displayed, where you can:
    • use the month scroll back ('<') or forward ('>') icons to choose a different month.
    • use the year scroll back ('<<') or forward ('>>') icons to choose a different year.
      (info) If you click and hold one of these scroll icons, a dropdown menu appears, allowing you to select a month or year from the list of options provided.
    • click the hour to increase it (or <Shift> click to decrease it).
    • click the minute to increase it (or <Shift> click to decrease it).
    • click 'am' / 'pm' to toggle between them.
  6. The Remaining Estimate field affects the value of the issue's Remaining Estimate  value. Select one of the following:
    • 'Adjust Automatically' — Select this if you want to automatically subtract your Time Spent from the issue's current Remaining Estimate value.
    • 'Leave Estimate Unset' — Select this if you do not want to specify any time estimates for the issue.
      (info) This option is only displayed if no time estimates have been specified.
    • 'Use existing estimate of ...' — Select this if you do not want to change the issue's Remaining Estimate value.
      (info) This option is displayed if a time estimate has been specified.
    • 'Set to ...' — Select this if you want to manually set the issue's Remaining Estimate value to the amount specified. If you select this option, enter your new estimate into the blank field below. Use 'w', 'd', 'h' and 'm' to specify weeks, days, hours or minutes. For example, to specify 'thirty minutes', type '30m'.
    • 'Reduce by ...' — Select this if you want to manually reduce the issue's Remaining Estimate value by the amount specified. If you select this option, enter your new estimate into the blank field below. Use 'w', 'd', 'h' and 'm' to specify weeks, days, hours or minutes. For example, to specify 'thirty minutes', type '30m'.
  7. In the Work Description field, type a description or comment about the work you have done.
  8. Click the padlock icon to either set this work log to be viewable only by members of a particular project role or group; or you can allow all users to view it.
    (info) For users to view a work log, they must have the Browse Project permission to view the issue and be a member of the project role or group selected in this step.
  9. Click Log at the bottom of the dialog to submit the form and close this window.
    • the Time Spent that you just entered has been added to the issue's total Time Spent field.
    • the Remaining Estimate value that you just entered (or chose) matches the issue's Remaining Estimate field.

Logging work while resolving or closing an issue

In addition to logging work when viewing an issue, you can also log work when resolving or closing an issue.

To log work on an issue while resolving or closing the issue:

  1. Navigate to the issue and view its details.
  2. Select either Workflow > Resolve Issue or Workflow > Close Issue.
  3. Edit the Log Work fields as described under the Logging work when viewing an issue section above.

    Icon

    By default, JIRA should automatically copy the contents of your Comments to the Workflow Description. In doing so, the work log will be visible to members of the project role or group selected in the padlock icon dropdown.

    If this is not happening and you would like comments to be copied to workflow descriptions, request that your JIRA administrator enables JIRA's Copy Comments to Workflow Descriptions setting.

    If this setting is disabled:

    • The work log entry may be visible to anyone. If this is a concern, you need to edit this work log entry after creating it to modify its visibility.
    • Copying comments to workflow descriptions must be done manually after logging work.
  4. Click Resolve (or the appropriately named button for your workflow transition or action) to return to the issue and verify that:
    • The Time Spent that you just entered has been added to the issue's total Time Spent field.
    • The Remaining Estimate value that you just entered (or chose) matches the issue's Remaining Estimate field.
Icon

If your JIRA administrator has added the ability to log work on other workflow transition sreens in JIRA's default workflow (or a d workflow), you will be able to log work during those workflow transitions too. Additionally, if your JIRA administrator has if your JIRA administrator has added this ability to JIRA screens used by other issue types, you can log work when creating or editing these types of issues.

Editing a work log entry

  1. Navigate to the issue and view its details.
  2. Locate the Activity section and select the Work Log tab.
  3. Locate the work log entry you wish to edit.
  4. Click the Edit (pencil) icon, located at the right of the work log entry.
  5. The Edit Work Log screen is displayed. Edit the fields as described under the Logging work when viewing an issue section above.
    (info) Be aware that when you are editing a work log entry, you cannot specify an amount of time by which to reduce the Remaining Estimate. Hence, the 'Reduce By...' field is not available on the Edit Work Log screen.
  6. Click Log to return to the issue, and verify that:
    • the word edited is displayed to indicate that the work log entry has been edited. You can hover your mouse over this word to see who edited the work log and when this was edited.
    • the issue's total Time Spent field has been adjusted as per the Time Spent that you just edited.
    • the issue's Remaining Estimate value field has been adjusted as per the Remaining Estimate value that you just edited.
Icon

You can edit your own work log entries if you have been granted the Edit Own Work Logs permission. You can edit other people's work log entries if you have been granted the Edit All Work Logs permission.

Deleting a work log entry

  1. Navigate to the issue and view its details.
  2. Locate the Activity section and select the Work Log tab.
  3. Locate the work log entry you wish to delete.
  4. Click the Delete icon, located at the right of the work log entry.
  5. The Delete Worklog screen is displayed. The Adjust Estimate field affects the value of the issue's Remaining Estimate. Select one of the following:
    • 'Auto Adjust' — Select this if you want to automatically add the work log entry's Time Spent value back to the issue's current Remaining Estimate value.
    • 'Leave existing estimate of ... ' — Select this if do not want to change the issue's Remaining Estimate value.
    • 'Set estimated time remaining to ...' — Select this if you want to manually set the issue's Remaining Estimate value to the amount specified. If you select this option, enter your new estimate into the blank field below. Use 'w', 'd', 'h' and 'm' to specify weeks, days, hours or minutes. For example, to specify 'thirty minutes', type '30m'.
    • 'Increase estimated time remaining by ...' — Select this if you want to ...
  6. Click Delete to confirm the deletion and return to the issue. Verify that:
    • the issue's Work Log tab no longer displays the work log entry that you just deleted.
    • the issue's History tab displays the Worklog Id (but not the description) of the deleted work log entry.
    • the issue's Time Spent field has been decreased by the value of the deleted work log entry's Time Spent.
    • the issue's Remaining Estimate field has been adjusted according to your choice in Step 6 (above).
Icon

You can delete your own work log entries if you have been granted the Delete Own Work Logs permission. You can delete other people's work log entries if you have been granted the Delete All Work Logs permission.

Customized JIRA installations

Logging work and/or specifying time estimates on the same JIRA screen

As described above, you can log work when viewing, resolving or closing an issue or specify time estimates when creating or editing an issue.

However, JIRA can be customized to allow work logging and specifying time estimates on the same JIRA screen when performing any JIRA operation, such as editing or creating an issue, or transitioning an issue to another status. To do this, your JIRA administrator must add both the Log Work and Time Tracking fields to the appropriate screen used by that operation.

To log work and/or specify time estimates on the same JIRA screen:

  1. Navigate to the issue and view its details.
  2. Perform the customized JIRA operation that allows you to log work and specify time estimates on the same JIRA screen. For example, assuming that your JIRA administrator has added the Time Tracking fields to the Resolve Issue Screen (and assuming this screen also retains the default Log Work fields), select Workflow > Resolve Issue at the top of the issue.

  3. If logging work is optional (because your JIRA administrator has configured the Log Work fields as optional), then you can choose whether or not to log work during your JIRA operation, using the Log Work check box.

    • If you select the Log Work check box, the Log Work fields become available and the Remaining Estimate field changes to the Remaining Estimate options for logging work.

    • If the Log Work fields are mandatory (because your JIRA administrator has configured them so), then the Log Work check box will not be available and you must log work during the workflow transition.

      (info) For more information about how to modify these fields, please refer to the Logging work when viewing an issue section above.

      Icon

      If you are not creating an issue or Sub-Task or not explicitly using the Log Work action (above), only the Comment field (not the Work Description field) will be available for entering a description of the work activity logged.

      By default, JIRA should automatically copy the contents of your Comment to the Workflow Description. In doing so, the work log will be visible to members of the project role or group selected in the padlock icon dropdown.

      If this is not happening and you would like comments to be copied to workflow descriptions, request that your JIRA administrator enables JIRA's Copy Comments to Workflow Descriptions setting.

      If this setting is disabled:

      • The work log entry may be visible to anyone. If this is a concern, you need to edit this work log entry after creating it to modify its visibility.
      • Copying comments to workflow descriptions must be done manually after logging work.

See also

40 Comments

  1. As you mentioned here people allowed to post their effort if:

    • have appropriate permission
    • time tracking is allowed

    At the same time there is a trick to disable logging work by adding "jira.issue.editable=False" property to particular status in workflow (like it's done for "Close" status for regular workflow).

    What can I do if I need to disable logging of work:

    • for definite entity type (e.g. custom "Artefact" type)
    • keeping it editable
      ?

    I found interesting implementation - https://studio.plugins.atlassian.com/wiki/display/KAAM/4.Kaamelot+FastWorklog
    Atlassian product, also based on JIRA and using separate "jira.issue.workable=False" property to drive the "Log Work" operation

    It's easy to set and use - it fits all my needs, BUT my 4.0.1 JIRA doesn't recognize this key!!!
    At the same time I see the following in the sources of my JIRA (JIRA.jar/templates/plugins/operations/logwork.vm):
    if ($issueoperation.isWorkable($issue))

    It seems like this operation can be driven by properties.
    I tried different keys, but failed to find appropriate.

    Could you help me to find the way how to manage to hide/show this operation without changes in the code of JIRA and make it against particular entity type (rather than groups/roles - it's not permissions related request)?

    1. Hi Alexander,

      The mentioned key was managed by Kaamelot pluigin, and now by Minyaa.

      See documentation at http://www.minyaa.com/documentation/latest/Features/ModuleTime/WorklogPermissions/WorkableIssue.html

      Vincent

  2. I figured I would add a comment about how if you are looking to restrict viewing of Worklogs, etc (because anyone w/ Browse permission can see work log information), you should vote on this issue http://jira.atlassian.com/browse/JRA-2364

  3. Anonymous

    When user logs work when resolving an issue is "Work Logged On Issue" event fired?

  4. Anonymous

    Why not change the remaining value to zero automatically when the task is resolved?

    1. Interested in the answer to **this** question!

      1. Anonymous

        This would be useful, maybe as an option in Time Tracking?

        1. Anonymous

          But maybe when an Issue is Closed rather than Resolved

          1. You can set the remaining to 0 as a post function in the workflow.  I had this set up in the event that someone forgot to do that.  Made our reporting so much cleaner!

            1. Kalynn, can you share the details of how you implemented this?  Unfortunately, I'm not the admin for our JIRA deployment.  But, I really need to zero out remaining work on close of the issue to make all our charts and so forth look right.

              1. Unless you have permissions to manually edit others work log and change the remaining estimate to 0h (this is on your project's permission scheme), you will need to have your admin modify the workflow that is associated with your Close transition.  When the admin navigates to the Close transition, one of the options is to set Post Functions.

                Create a Post Function > select Update Issue Field > Select Remaining Estimate field  and input  0h as the Field Value and then > Add

                Once the workflow is published, then it should work.

                1. Kalynn, Thanks so much.  This sounds easy to do for the admin.

                  Question:  Does the post change apply to all projects on the single JIRA instance globally?  Or can I apply this change to posting for a single project?

                  1. It will apply to all projects that are assigned a workflow scheme that includes the workflow that you implemented this post function in.  So, it's really up to you what you would like.  If you want it on all projects, then you will want to do this for all workflows and each of their Close transitions.

                    If you use the Design mode workflow editor (in one of the latest JIRA versions), you can update the global Close transition and add this post function which makes it easier to implement these changes.   Global transitions are not available when viewing the workflow in Text mode.

  5. Anonymous

    +1 or add check box for this action at resolve screen

  6. Anonymous

    How do you log work for specific dates after the fact?  Our developers do not want to log work necessarily immediately, but perhaps once per week, similar to filling out a time card.  So for example, on Friday I will log work for the entire week on many issues, but do not want to have it appear that I did 40 hours of work on Friday.  Is this possible?

  7. Anonymous

    I'm having an issue where time estimates are not calculating for some users. Users who were first added to Greenhopper are displaying fine, but everyone else doesn't display their time estimates on the Planning Board.

  8. Feature Request: The "Work Description" should show up in the JIRA project Activity Stream just like comments! Is there a way to configure it to do this?

  9. Anonymous

    I have a problem,where I am not able to update or delete the time logged by me.when I contact the administrator he didn't find the option to provide rights to me.Can anyone provide me the steps to give permissions to me.first of all please let me know are there any separate Add-on 's required on top of JIRA license to have these level of permissions

  10. Anonymous

    Can timetracking to be switched off per Project

  11. Anonymous

    Hi!

    How can I add a custom field in 'Work Log' tab like Work Description?

  12. Anonymous

    It would be awesome if you could log time for someone else.  For example, many of the cases we create at my company involve some kind of discussion or knowledge transfer component.  In these cases, it's important for everyone involved to log their time.  It would be much more convenient if the case assignee/owner could log everyone's time, instead of needing to remind everyone to log time to that case.

    1. Anonymous

      This would indeed be a fantastic feature. As a project manager I find that I have to go in and log work for people after the fact because they forget. I could just slap them but my hands are getting sore (wink)

    2. Anonymous

      Yes yes yes!  This is a basic project management need, sorely missing.  Also, where is the calendar view for resources where you can put in their PTO?

  13. Anonymous

    How to reduce / decrease the Time Spent ?

     

  14. Anonymous

    I have similar doubt; How to reduce / decrease the Time Spent ? by mistakenly I have logged additional hours; how can modify the time spent?

    1. Anonymous

      Go to the "Work Log" tab, then you can find logged works.

      You can edit it.

  15. Anonymous

    I used JIRA 5.1,but I cannot find the OriginalEstimate field  in Log work

    1. I had a similar issue and question as the instructions are not clear.  Check to make sure that you have added Time Tracking as field to the screen associated with the issue types you want to capture estimates.

  16. If I link an issue as 'part of' some master task.  Is it possible for that master task to include the contained issue in its total work estimate similar to a subtask?

  17. Anonymous

    Is there a way to delete multiple work logs from 1 issue.

  18. Anonymous

    Hello,

     

    ¿It's possible to limit the values of the Worklog only in hours? We want that the people put in the worklog of the issue in hours, none in minutes, days or weeks.

    ¿Any help please?

     

    Thanks!

  19. Anonymous

    I use Recent Worklogs add for my team so they don't skip a day 

    https://marketplace.atlassian.com/plugins/com.marketingquantum.quantum

  20. Anonymous

    Hello When I'm trying to insert a Work Log for more than nearly a year ago(today is 17/Apr/13 - last possible entry is 1/Jul/12), the Work Log Window brings the following Message :

    "date is closed for registration".

    Is there any posibility du increase this period to enter past dates for more then one year. When yes, where can I set it up ?

  21. Anonymous

    A question on the subject of time entry: IF an issue has an estimated 10 hours of work (for instance), and 4 are completed in a version (we use version to mean months and monitor what work we are doing each month), is there a way that I can carry this issue to the next version WITHOUT duplicating the issue and hand-calculating the remaining time?

  22. Hi, I would like to know if is there an option to send a notification when log time worked is reaching estimating time.

    At least one hour left  or whatever you want.

    Thank you.

  23. Anonymous

    It would be nice if there was an easy way to see the time between NOW and when I clicked 'start progress'. I can look through the activity log... but that's a bit of a hassle. Logging time work is great... but it's a hassle to keep track of when I started and stopped manually.

     

  24. Hi,

    is it possible to customize issue detailed view screen that log work will be shown here?

    I mean - https://docs.google.com/file/d/0B0RF5_K3PYe4X0x4Q0JDRUtJWVE/edit

    Thanks

  25. Hello,

    I didn't add Original Estimate in a task type issue. Now I try to add it (40 hours of work estimated: 40h) but when I save and go back to edit the issue I see it is set to 1w (I guess that's 1 week). Am I missing something in time tracking configuration? Thanks.

  26. The Viewable by solution would be great if it also included Time tracking. The tab says no work logged but the Time Tracking part shows the time. Can be good to point out in the text. 

  27. Hi,

    How can I set in the "Log Work" screen to show already logged hours? It can be seen in the report but not in the "Log Work" Screen. Just like in the second picture in this document, the field "Logged" to appear in the third picture. Just under "Time Spent".