Countdown fields and settings

Every field well and every setting in the format pane of version 1.0.1.0, read from the package you download. The internal names in grey are what a PBIR file or a report-authoring agent uses. Which features need a licence is on the Countdown page; every setting works in edit mode with or without one.

9 fields · 15 cards · 107 settings Markdown for AI assistants catalog.json

Fields

Field	Takes	Needed	What it is for
Deadline`target`	Column or measure	Optional	The date to count down to. Leave empty and set a date in the format pane instead.
Event dates`events`	Column	Optional	Dates of the events to count up FROM - incidents, resets, releases. Bind the whole column and the visual also reports the best streak on record.
Start`start`	Column or measure	Optional	Start of the window, for the progress layout.
Non-working dates`holidays`	Column	Optional	Dates that are never working days - public holidays, shutdown weeks. Use a column from the same table as your dates.
Caption`label`	Column	Optional	Text shown above the number.
Reference time`reference`	Measure	Optional	Optional model clock, e.g. UTCNOW(). Used only to correct a viewer device clock that is running behind.
Actual`actual`	Measure	Optional	How much is done so far. With Goal and a window, the visual reports the run rate you still need.
Goal`goal`	Measure	Optional	The number Actual has to reach by the deadline.
Tooltips`tooltips`	Measure	Optional	Extra fields to show in the tooltip.

Countdown`countdown`

Setting	Type and options
Mode`mode`	Countdown (to a deadline) `countdown` Days since (count up) `countup` Progress (start to end) `progress` Auto (from the fields) `auto` Deadline board (many rows) `board` Milestone track (timeline) `track` Pace (are we on track) `pace`
Date (When No Field Is Bound)`staticTarget`	Text
When The Column Has Many Dates`targetPick`	Next one still ahead `nextFuture` Latest date `latest` Earliest date `earliest` Most recent past date `lastPast`
After It Reaches Zero`afterZero`	Keep counting (overdue by) `countup` Stop at zero `stop` Show a message `message` Roll to the next occurrence `roll`
Message At Zero`zeroText`	Text
Show Tenths Of A Second`showTenths`	On / off

Days Since`streak`

Setting	Type and options
Show Current Streak`showCurrent`	On / off
Show Best Streak`showBest`	On / off
Show When The Best Was Set`showBestDate`	On / off
Count In`countIn`	Calendar days `calendar` Working days `working` Shifts `shift`
Best-Streak Label`bestLabelText`	Text
Current-Streak Label`currentLabelText`	Text

Deadline Board`board`

Setting	Type and options
Sort Rows By`sortBy`	Soonest first `urgency` Latest first `urgencyDesc` Data order `data` Caption A to Z `label`
Overdue Rows First`overdueFirst`	On / off
Maximum Rows`maxRows`	Number
Row Height`rowHeight`	Number
Show Row Dividers`showDivider`	On / off
Say How Many Rows Are Hidden`showMoreFooter`	On / off
Show State Chip On Each Row`showRowState`	On / off
Show The Date On Each Row`showRowDate`	On / off

Milestone Track`track`

Setting	Type and options
Show The Now Marker`showNowMarker`	On / off
Show Grid Lines`showGrid`	On / off
Labels`labelPlacement`	Alternating `alternate` Above `above` Below `below` None `none`
Marker Size`dotSize`	Number
Show The Date Axis`showAxisLabels`	On / off

Pace`pace`

Setting	Type and options
Show The Required Rate`showRequiredRate`	On / off
Spread Over`rateBasis`	Calendar days `calendar` Working days `working`
On-Track Band (% Of Goal)`onTrackBand`	Number
Show The Projected Finish`showProjection`	On / off
Show The Gap To Plan`showPlanDelta`	On / off
Ahead Color (Empty = Theme)`aheadColor`	Colour
Behind Color (Empty = Theme)`behindColor`	Colour

Time Zone`timezone`

Setting	Type and options
Deadline Time Zone`zoneKind`	Report viewer's local zone `viewer` UTC `utc` Fixed offset `offset` Named zone `iana`
Fixed Offset (e.g. +02:00)`fixedOffset`	Text
Named Zone (e.g. Europe/Prague)`ianaZone`	Text
A Day Ends At`dayRollover`	Local midnight `local` UTC midnight `utc`
Show The Zone On The Visual`showZoneChip`	On / off

Units`units`

Setting	Type and options
Largest Unit`largestUnit`	Days `d` Hours `h` Minutes `m` Seconds `s`
Smallest Unit`smallestUnit`	Days `d` Hours `h` Minutes `m` Seconds `s`
Hide Seconds Beyond (Hours, 0 = Never)`autoCollapseSeconds`	Number
Day Counting`breakdownMode`	Auto (calendar days) `auto` Calendar days `calendar` Exact 24-hour days `duration`
Leading Zeros`leadingZeros`	Auto `auto` Always `always` Never `never`
Language Of The Words`unitLanguage`	English `en` Follow the report locale `report`
Unit Labels`unitLabelStyle`	Full words `long` Short (d h m s) `short` None `none`
Unit Label Position`unitLabelPosition`	Below the number `below` Beside the number `inline`
Word For Days`labelDay`	Text
Word For Hours`labelHour`	Text
Word For Minutes`labelMinute`	Text
Word For Seconds`labelSecond`	Text

Working Time`workingTime`

Setting	Type and options
Count Working Time`enabled`	On / off
Sunday`day0`	On / off
Monday`day1`	On / off
Tuesday`day2`	On / off
Wednesday`day3`	On / off
Thursday`day4`	On / off
Friday`day5`	On / off
Saturday`day6`	On / off
Limit To Business Hours`businessHours`	On / off
Business Hours Start (HH:MM)`businessStart`	Text
Business Hours End (HH:MM)`businessEnd`	Text
Non-Working Dates (One Per Line)`holidayDates`	Text
Show The Working-Day Readout`showWorkingReadout`	On / off

Recurrence`recurrence`

Setting	Type and options
Repeats`unit`	Does not repeat `none` Daily `day` Weekly `week` Monthly `month` Quarterly `quarter` Yearly `year` End of every month `monthEnd` End of every quarter `quarterEnd` End of the fiscal year `fiscalYearEnd`
Every N`every`	Number
On`weekday`	Sunday `0` Monday `1` Tuesday `2` Wednesday `3` Thursday `4` Friday `5` Saturday `6`
Day Of The Month`dayOfMonth`	Number
Month (Yearly)`month`	Number
At (HH:MM)`timeOfDay`	Text
Fiscal Year Starts In Month`fiscalYearStartMonth`	Number

Style`style`

Setting	Type and options
Layout`style`	Plain `plain` Blocks `blocks` Flip clock `flip` Ring `ring` Bar `bar` One line `inline`
Separator`separator`	Auto (theme) `auto` Colon : `colon` Dot · `dot` Slash / `slash` None `none`
Blink The Separator`separatorBlink`	On / off
Ring Thickness`ringThickness`	Number
Bar Height`barHeight`	Number
Animation`animation`	Auto (theme) `auto` None `none` Fade `fade` Flip `flip`

Text`text`

Setting	Type and options
Font`fontFamily`	Inter `inter` Segoe UI `segoe` Arial `arial` Georgia `georgia` Monospace `mono`
Fit The Number To The Visual`autoFit`	On / off
Number Size`valueSize`	Number
Unit Label Size`unitSize`	Number
Caption Size`captionSize`	Number
Alignment`align`	Center `center` Left `left` Right `right`
Number Color (Empty = Theme)`valueColor`	Colour
Unit Label Color (Empty = Theme)`unitColor`	Colour
Caption Color (Empty = Theme)`captionColor`	Colour

States`states`

Setting	Type and options
Show State Icon`showIcon`	On / off
Show State Label`showStateLabel`	On / off
Warning When Within`warningValue`	Number
Warning Unit`warningUnit`	Days `d` Hours `h` Minutes `m`
Critical When Within`criticalValue`	Number
Critical Unit`criticalUnit`	Days `d` Hours `h` Minutes `m`
Normal Color (Empty = Theme)`normalColor`	Colour
Warning Color (Empty = Theme)`warningColor`	Colour
Critical Color (Empty = Theme)`criticalColor`	Colour
Overdue Color (Empty = Theme)`overdueColor`	Colour
Warning Label`warningText`	Text
Critical Label`criticalText`	Text
Overdue Label`overdueText`	Text

Caption`caption`

Setting	Type and options
Show Caption`showLabel`	On / off
Caption Text (Empty = From Data)`labelText`	Text
Show The Target Date`showTarget`	On / off
Target Date Format`targetFormat`	Date and time `dateTime` Date only `date` Long date `full`
Show "As Of" Stamp In Exports`showAsOf`	On / off

Theme`theme`

Setting	Type and options
Theme`selectedTheme`	SmartVisuals `smartvisuals` Dark `dark` Clean `clean` Slate `slate`
Background Color (Empty = Theme)`bgColor`	Colour
Transparent Background`transparentBg`	On / off

Diagnostics`diagnostics`

Setting	Type and options
Warn About Rows That Are Not Dates`showSkipped`	On / off
Show Where The Clock Comes From`showClockConfidence`	On / off

Setting a value in PBIR

In a visual.json, a setting goes under visual.objects, by card and internal name. Toggles take true or false, choices and text a value in single quotes ('auto'), numbers a D suffix (12D).

"visual": {
  "visualType": "countdownTimer1F116F5EB2844AFDA3D921F4012C0E5C",
  "objects": {
    "countdown": [{
      "properties": {
        "showTenths": { "expr": { "Literal": { "Value": "true" } } }
      }
    }]
  }
}

Countdown fields and settings

Fields

Countdowncountdown

Days Sincestreak

Deadline Boardboard

Milestone Tracktrack

Pacepace

Time Zonetimezone

Unitsunits

Working TimeworkingTime

Recurrencerecurrence

Stylestyle

Texttext

Statesstates

Captioncaption

Themetheme

Diagnosticsdiagnostics