Time in Status custom field

Owned by Derya Özdemir
Last updated: Oct 17, 2024 by Derya Özdemir
4 min read

This page is about JEP for Jira DC. Using Cloud? Click here.

The Time in Status custom field is a powerful tool for tracking the duration that issues spend in specific statuses within your Jira instance. It provides granular insights into workflow efficiency, identifies bottlenecks, and supports data-driven decision-making. It can be configured to work against a specific working calendar.

It displays the total time passed during the selected status(es).

image-20241017-184028.png

When clicked, it displays all the details:

image-20241017-184229.png

On this page:

On this page:

Step 1: Create a Time in Status custom field

  1. From Jira settings, navigate to Manage Apps.

  2. From the side menu, find Enhancer Plugin for JIRA.

  3. Click Custom Field Configuration.

  4. Click on the Add New JEP custom field button.

  5. Click the Duration tab on the left-hand side of the dialogue. 

  6. Select Time in Status, then click Add custom field.

Step 2: Configure the field

  1. Fill in the dialog box that appears.

  • Name – Provide a descriptive name for the custom field.

  • Status(es) – Select the status(es) that you want to calculate the amount of time spent in.

  • Working calendar – Choose a working calendar (defined in Jira Admin > Manage apps > ENHANCER PLUGIN FOR JIRA > Calendars) to calculate time based on specific work hours.

  • Occurance – Specify whether to display the first, last, or cumulative occurrence of the status.

  • Grouping field – Determine the field by which the time in status details are grouped (e.g., Assignee, Project).

  • Time format –  Configure the display options (both for the issue main view, navigator view, and board view). The Use Separator lets you define your own separator for the time display. You can also choose to not have a separator.

     

  1. Click the Save custom field button.

You must link the custom field with the appropriate screens to see them. For more information, refer to the Jira documentation.

Usage in JQL searches

The Time in Status Custom Field comes with a powerful searcher. You can use this custom field in your JQL statements to filter issues by status and then by the value of the Grouping Field of your choice.

timeSpentBy(), timeSpentInStatus() and timeSpentInStatusBy() JQL functions can be used as right-hand functions with the custom field.

Below are some examples:

  • Searching against total duration including every grouping field value within the selected status(es):

    "Time in Review" >= 4d

  • Searching against a single user:

    (In this example, the grouping field could be set to "Assignee") 

    "Time in Open" <= timeSpentBy("5d", "agrant")

  • Searching against multiple groups. The below function searches time spent by the groups (jira-developers, jira-users, and jira-administrators) in 'Waiting for support status' for more than 5 calendar days:

    (In this example, the grouping field could be set to a group picker custom field)

    "Time in Waiting for support" >= timeSpentBy("5d", "jira-developers", "jira-users ", "jira-administrators")

  • Searching by the IDs of status(es). When the custom field is defined with multiple statuses, but you want to filter by some of them with the status IDs:

    (Where 1 is the ID of the status Open).

  • Searching by the names of the status(es). When the custom field is defined with multiple statuses, but you want to filter by some of them with the status names:

  • Searching by status ID and the grouping field value:

    (Where 3 is the ID of the status Open, the grouping field is "Assignee", and “agrant” is the username).

  • Searching by status name and the users:

    (Where the grouping field is set to a single user picker and “hjennings” is the username).