Countdown for Jira

A dashboard gadget that shows how many days are left until a date you choose.

It only reads a date you type in. Countdown does not read your issues, your projects, or anything else in Jira. It asks for no permissions at all, and it stores nothing except the settings of the gadget itself.

Install it

Open Settings → Apps → Find new apps in your Jira site.
Search for Countdown by Onesty and select Get app.
You need to be a Jira administrator to install apps. If you are not, send this page to the person who is.

Add it to a dashboard

Go to Dashboards and open the dashboard you want, or create a new one.
Select Edit, then Add gadget.
Find Countdown in the list and select Add.
The settings form opens straight away. Fill it in and select Save.

Settings

Field	What it does
Title	The label shown above the number. For example Release freeze.
Target date	Required. The day you are counting down to.
Start date	Optional. Set it and a progress bar appears, showing how far along you are.
Count	Calendar days counts every day. Business days skips Saturday and Sunday.
Warn when days left is under	The number turns amber at or below this. Default 7.
Alert when days left is under	It turns red at or below this. Default 3. It is capped at the warn value.
Show progress bar	Only has an effect when a start date is set.

About business days

Business days skip Saturday and Sunday. Public holidays are not skipped. Holidays differ by country and by company, and a built-in list would be wrong for most people, so Countdown does not guess.

Which day is “today”

The count uses the date on the device you are looking at. Two people in different time zones may briefly see a different number near midnight. This is intentional — you want the answer for your calendar.

Change the settings later

Hover over the gadget and select the ••• menu in its top-right corner.
Select Edit (on some dashboards this is under the dashboard’s own Edit mode).
Change what you need and select Save.

Remove it

Remove one gadget

Open the gadget’s ••• menu and select Remove. This deletes that gadget and its settings. Nothing else is affected — Countdown never writes to your issues, so there is nothing left behind.

Uninstall the app

Open Settings → Apps → Manage apps.
Find Countdown and select Uninstall.
Any Countdown gadgets still on dashboards stop showing. Your dashboards and issues are untouched.

If something looks wrong

What you see	What to do
“Not configured yet”	No target date is set. Open the gadget menu and select Edit.
The number is one day off	Check whether you meant calendar days or business days, and check the date on your own device.
“Subscription required”	The licence has lapsed. Your Jira administrator can renew it under Settings → Apps.
The gadget is blank	Reload the page. If it stays blank, write to us with your Jira site address and we will look.

Support

Write to [email protected]. A person reads every message. Telling us your Jira site address and what you expected to see saves a round trip.