Configuring Time Tracking

JIRA's Time Tracking feature enables users to record the time they spend working on issues (see Logging Work on an Issue).

(warning) Note: Before users can specify time estimates and log work, they must be granted the Work On Issues permission for the relevant project(s).

Disabling Time Tracking

Time Tracking is ON by default (as shown in screenshot 1 below). However, this feature can be disabled from the Time Tracking administration page.
(info) Time tracking will be OFF by default if your JIRA installation was upgraded from a version prior to 4.2 that had time tracking either disabled or never enabled.

To disable Time Tracking:

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > System. Select Issue Features > Time Tracking to open the Time Tracking page.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'time t'
  3. Click the 'Dectivate' button to turn Time Tracking OFF.

(info) You will not lose any existing Time Tracking data by disabling/re-enabling Time Tracking.

On this page:

 Time tracking add-ons for JIRA in the Atlassian Marketplace extend JIRA's time tracking power. Check them out here.

Enabling Time Tracking

To enable Time Tracking:

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > System. Select Issue Features > Time Tracking to open the Time Tracking page.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'time t'
  3. Click the 'Activate' button to turn time tracking ON.


Screenshot 1: Time Tracking is ON

Configuring Time Tracking Settings

To edit JIRA's Time Tracking settings, it must first be disabled. Once you have changed the settings, you will then need to re-enable Time Tracking so that users can log work on issues.

(info) You will not lose any existing Time Tracking data by disabling/re-enabling Time Tracking.

To configure Time Tracking settings:

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > System. Select Issue Features > Time Tracking to open the Time Tracking page.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'time t'
  3. If Time Tracking is ON (refer to the indication at the top of the Time Tracking screen), click the 'Deactivate' button to turn Time Tracking OFF.
  4. The Time Tracking settings will now be editable as shown in the following screenshot.
    Screenshot 2: Time Tracking is OFF
  5. Configure Time Tracking settings by editing the following fields:
    • 'Hours per day' — enter a suitable value (e.g. 8). You can enter fractions if you wish.
    • 'Days per week' — enter a suitable value (e.g. 5). You can enter fractions if you wish.
    • 'Time format' — select pretty/days/hours. This will determine the format of the 'Time Spent' field when an issue is displayed.
    • 'Default Unit' — select minutes/hours/days/weeks. This will be applied whenever your users log work on an issue without specifying a unit.
    • 'Legacy Mode' — select this check box if you prefer to use JIRA's time tracking features as they operated prior to JIRA version 4.2. For more details about this option, please see About 'Legacy Mode' (below).
    • 'Copy Comment To Work Description' — select this check box to ensure that any content entered into a Comment field while logging work as part of an issue operation, is also copied across to the Work Description.
      (info) When 'Copy Comment To Work Description' is enabled, your user's work log entries will be visible only to members of the project role or group selected in the padlock icon dropdown on their issue operation screen. If 'Copy Comment To Work Description' is disabled, your user's work log entries will be visible to anyone by default.
  6. Click the 'Activate' button to turn time tracking ON.
    If the permission schemes used by your project(s) already have the appropriate Work On Issues permissions, then there is no need to proceed any further.
    However, if you need to configure these permissions, proceed with the remaining steps below:
  7. Click the 'permission scheme' link as shown in screenshot 1 (above). The 'Permissions Scheme' page will be displayed.
  8. Click the 'Permissions' link of the permission scheme associated with the project(s) where you wish to specify Work On Issues permissions. The 'Edit Permissions' page is displayed for your chosen permission scheme.
    (info) See Managing Project Permissions for details about the various permissions.
  9. Check whether the row labelled 'Work On Issues' contains the appropriate users, groups or project roles who need to specify time estimates or log work. If it does not, click the 'Add' link in the 'Operations' column:
    Screenshot 3: Time Tracking Permissions
  10. Select the users, groups or project roles to whom you want to allow time tracking and work logging on issues.
  11. Click the 'Add' button.
  12. If it is needed to enter the 'Original Estimate' during issue creation or during issue editing, ensure that the field 'Time Tracking' is added to the relevant screens associated with those operations. Refer Associating a Screen with an Issue Operation for more details.

About 'Legacy Mode'

  • If Legacy Mode is disabled, your users will be able to change the Original Estimate value irrespective of any work being logged on an issue. Legacy Mode is disabled by default on new installations of JIRA version 4.2 or later.
  • If Legacy Mode is enabled, your users can only specify an Original Estimate before they start logging work on an issue. This value cannot be changed once any work has been logged, unless all work logs for that issue are first deleted.
  • By default,
    • Legacy Mode is disabled if your JIRA 4.2 installation was conducted cleanly (that is, without upgrading from an earlier version of JIRA).
    • Legacy Mode is enabled if you upgraded JIRA from a version prior to 4.2.
  • With Legacy Mode enabled, if you change the Remaining Estimate field in a workflow post function the Original Estimate is also cleared. This issue is tracked at  JRA-25031 - Time Tracking Legacy Mode and Workflow Post Functions Error Verified
  • Please refer to the Logging Work on an Issue and the JIRA 4.2 Release Notes for more information about logging work and modifying time estimates.

Related Topics

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport