Skip to main content

Countdown

A Countdown field shows the working time left until a deadline, such as the due date, the sprint end or the release date.

Only working time on a work calendar counts. Once the deadline passes, the number turns negative.

What you see​

On the work item, you see how much time is left, such as 2d 4h left or 3h 40m left.

After the deadline, it reads 1d 5h overdue.

A second line names the deadline and its date.

You see it in amber under one working day left, in red when overdue, and in green when the work finished early.

When you hover over the value, you see it in its unit and the work calendar it counts on.

Lists show the same wording. Search, sorting and exports use the stored number.

Presets​

A new field starts with the Days until due preset.

You can select another preset under Start from a preset and then change any setting.

PresetCounts down toWhen the work item is done
Days until dueThe due dateKeeps how early or late it finished
Time left in sprintThe end of the work item's sprintEmpty
Days to releaseThe release date of its fix versionKeeps how early or late it finished

Settings​

SettingWhat it doesDefault
Count down toDue date, Another date field, End of the work item's sprint or Release date of its fix versionDue date
When the work item is doneKeep how early or late it finished, or leave the field emptyKeep how early or late it finished
Work calendarOnly working hours count, minus breaks and holidays, in the calendar's time zoneThe 24/7 calendar
Store the value inWorking days (2 decimals), Hours (2 decimals) or Minutes (whole minutes)Working days (2 decimals)

A working day is the calendar's average working day. On the 24/7 calendar, it's 24 hours.

Deadlines​

A date without a time counts to the end of that working day. A date and time counts to that moment.

The sprint end is the active sprint's end. Without an active sprint, it's the next future sprint's end.

The release date is the earliest one among the unreleased fix versions. If no unreleased fix version has a date, FieldCraft takes the earliest dated one, even a released one.

Without a deadline, the field is empty.

Done work​

Done means a status in the Done category.

If you keep how early or late it finished, the value stops at Done. You then see, for example, Done 1d early or Done 2d late.

A reopened work item counts down again.

Example: working days until the due date​

You want to see the working time left before each work item is due.

  1. Create the field from the Days until due recipe, or open the configuration page of a Countdown field.

  2. Select the Days until due preset.

  3. In Work calendar, select your office-hours calendar, for example 8/5, Mon-Fri, 09:00 - 17:00.

  4. In Store the value in, keep Working days (2 decimals), and select Save.

Result: On Wednesday at 13:00, a work item due on Friday shows 2d 4h left. The stored value is 2.5.

Search with JQL​

JQL compares the stored number in the field's unit.

To find open work items that are overdue, earliest deadline first, use:

"Days until due" < 0 AND statusCategory != Done ORDER BY "Days until due" ASC

Keep statusCategory != Done in the query. Work that finished late also keeps a negative number.

If you change Store the value in, recalculate existing work items. Stored values switch to the new unit only then.

When the value updates​

FieldCraft recalculates the field when the work item's status or deadline changes. When a sprint or a version changes, its work items follow.

The work item view always shows you the current value. Lists and search move on every hour, less often when the deadline is far away.

See How values stay current.

Things to know​

  • Outside working hours, the value stands still, because no working time passes.

  • End of the work item's sprint needs Jira's Sprint field. Without it, you see This site has no Sprint field, so a sprint end can't be used.

  • You can't add a traffic light or progress bar. Countdown uses its own colors.

  • In Jira's list of field types, this type is FieldCraft: Countdown.