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.
| Preset | Counts down to | When the work item is done |
|---|---|---|
| Days until due | The due date | Keeps how early or late it finished |
| Time left in sprint | The end of the work item's sprint | Empty |
| Days to release | The release date of its fix version | Keeps how early or late it finished |
Settingsβ
| Setting | What it does | Default |
|---|---|---|
| Count down to | Due date, Another date field, End of the work item's sprint or Release date of its fix version | Due date |
| When the work item is done | Keep how early or late it finished, or leave the field empty | Keep how early or late it finished |
| Work calendar | Only working hours count, minus breaks and holidays, in the calendar's time zone | The 24/7 calendar |
| Store the value in | Working 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.
-
Create the field from the Days until due recipe, or open the configuration page of a Countdown field.
-
Select the Days until due preset.
-
In Work calendar, select your office-hours calendar, for example 8/5, Mon-Fri, 09:00 - 17:00.
-
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.
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.
Relatedβ
-
Flag work that is close to its due date: a complete setup for soon-due and overdue work.
-
Time Between: measure the time from one moment to another, such as cycle time.
-
Work calendars: set working hours, breaks, holidays and the time zone.
-
Search and report with FieldCraft fields: use the value in filters, boards and dashboards.