Documentation for JIRA 4.3. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

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

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

On this page:

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. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. On the panel on the left, under the title Global Settings, click on the link labelled 'Time Tracking' to open the Time Tracking administration page.
  4. 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.

Enabling Time Tracking

To enable Time Tracking,

  1. Log in as a user with the JIRA Administrators global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. On the panel on the left, under the title Global Settings, click on the link labelled 'Time Tracking' to open the Time Tracking screen.
  4. 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. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. On the panel on the left, under the title Global Settings, click on the link labelled 'Time Tracking' to open the Time Tracking screen.
  4. 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.
  5. The Time Tracking settings will now be editable as shown in the following screenshot.
    Screenshot 2: Time Tracking is OFF
  6. 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.
  7. 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:
  8. Click the 'permission scheme' link as shown in screenshot 1 (above). The Permissions Scheme page will be displayed.
  9. 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.
  10. 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
  11. Select the users, groups or project roles to whom you want to allow time tracking and work logging on issues.
  12. Click the 'Add' button.

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.
  • 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

  • Please see the section "Adding Time Tracking capabilities to a screen" on this page: Defining a Screen.