The Count Down / Count Up gadget displays a live, ticking timer driven by a single date. It works in two directions: it can count up from a date in the past — for example, "days since our last safety incident" or "days since launch" — or count down to a date in the future, such as a product release, event, or deadline.
The date can be typed directly into the gadget, or pulled from a Data Table so the value can be updated centrally without editing the template. You control the display format (colon, spaced, single-character, or a simple day count), which time segments appear, and the styling of both the counter and any completion message.
Adding the gadget
- Open the template where you want the timer to appear and add a new Gadget zone (or edit an existing one).
- From the gadget picker, select Count Down/Up App.
- Configure the date, direction, format, and styling using the preferences described below.
- Save the template. The gadget sizes itself to the zone automatically.
Choosing a date source
The Date Source setting determines where the gadget gets its date. The rest of the date settings change depending on which option you pick.
| Option | Description |
|---|---|
| Manually entered date | You type the date directly into the gadget. Best for fixed, one-off dates that rarely change. |
| From a data table column | The gadget reads the date from a Data Table in the CMS. Best when the date needs to be updated by someone other than the template designer, or when the same date drives content elsewhere. |
Manually entered date
When Date Source is set to Manually entered date, the Start/End Date field appears.
| Setting | Description |
|---|---|
| Start/End Date | The reference date for the timer. When counting up, this is the start date and the timer measures time elapsed since then. When counting down, this is the end (target) date and the timer measures time remaining until then. Enter the date in M/D/YYYY format (e.g. 6/16/2025), optionally with a time of day (e.g. 6/16/2025 5:00 PM) for a countdown to a precise moment. |
From a data table column
When Date Source is set to From a data table column, the Data table picker appears.
| Setting | Description |
|---|---|
| Data table | Select the Data Table that holds the date, then choose the column to read it from. Any Date-type column can be used. |
The value in the selected Date column drives the timer exactly as a manually entered date would, including an optional time component.
For help creating and managing Data Tables, see the Data Tables article.
Count direction
The Count Direction setting controls whether the timer runs forward or backward.
| Option | Description |
|---|---|
| Count up from the specified date | The timer starts at the reference date and increases — showing elapsed time. Runs indefinitely. |
| Count down to the specified date | The timer decreases toward the reference date and reaches zero when the date arrives, at which point the completion behavior (below) is triggered. |
Display format
Three settings work together to control how the timer reads on screen.
Separator Type
| Option | Example |
|---|---|
| Single character separator | 20h 31m 27s |
| Colon separator | 20 : 31 : 27 |
| No separator | 20 31 27 |
| Days only | 3 Days |
Tip: For long-running "days since" or "days until" counters, Days only is usually the cleanest choice — it drops the hours/minutes/seconds entirely and shows just a day count.
Time segments
For every separator style except Days only, these three toggles control which units appear. Turn off the segments you don't need for a tidier display.
| Setting | Default |
|---|---|
| Include Hours | On |
| Include Minutes | On |
| Include Seconds | On |
Note: These toggles have no effect when Separator Type is set to Days only, which always shows a single day count.
Styling
| Setting | Description |
|---|---|
| Counter Text style | Font, color, and size of the timer digits. Defaults to Open Sans, white, 38px. |
| Message Text style | Font, color, and size of the completion message (see below). Defaults to Open Sans, white, 38px. |
| Tile Color | (Optional) A background color for the timer tiles. Leave blank for a transparent background. |
Completion behavior (count down only)
When a count down timer reaches its target date, two optional actions can fire. These have no effect in count-up mode.
| Setting | Description |
|---|---|
| Completion Message | Text shown in place of the timer once the countdown reaches zero — for example, "We're live!" or "Event has started." Styled using the Message Text style above. |
| Command to send on completion | (Optional) A command sent to the player when the countdown completes. Use it to trigger other content or a player action — for example, other content can use a Command smart schedule condition that activates when this command fires. |
Example: "Days since our last incident" from a Data Table
A common use for count-up mode is a workplace safety board — "X days since our last incident" — where the reference date needs to be reset whenever an incident occurs. Driving it from a Data Table means a safety manager can reset the counter by editing one cell, with no access to the template required.
- Create a Data Table with a column holding the incident date and enter the most recent incident date. (See Data Tables.)
- Add the Count Down/Up App to your template.
- Set Date Source to From a data table column, select your table, and choose the Date column that holds the incident date.
- Set Count Direction to Count up from the specified date.
- Set Separator Type to Days only.
- Style the counter to suit the board, and set a Tile Color if desired.
- Save. To reset the counter after an incident, edit the date in the Data Table — no template change needed.
Tips
- Reset without touching the template. Any date that changes periodically — last incident, last deployment, days since a milestone — is a good candidate for the Data Table source, so non-designers can update it safely.
- Match the format to the timescale. Use Days only for multi-day counters and a colon or single-character separator for short countdowns where hours, minutes, and seconds matter.
- Completion message and command apply to countdowns. They fire when a count-down reaches zero; they do nothing in count-up mode.
Related to
Comments
0 comments
Please sign in to leave a comment.