A countdown link is https://count.live/? followed by parameters separated by &, for example https://count.live/?date=2026-12-31T23:59:59-05:00&title=New%20Year. Nothing is stored on our servers: change the link and you change the countdown.

While you edit a countdown, the builder keeps your work after the # in its own address (count.live/#date=…), so refreshing the page doesn’t lose it. The link to share is always the one in the Share panel.

URL parameters

ParameterWhat it doesExample
dateTarget date and time (ISO 8601). Without an offset it’s read as UTC; the builder always adds one.2026-12-31T23:59:59-05:00
tzIANA time zone the countdown belongs to. Used for repeating countdowns and calendar math, and shown with showtz=1.America/Los_Angeles
titleEvent title (max 50 characters)New Year
subtitleSubtitle text, can span several lines (max 200 characters)The countdown begins
endMessage shown when the countdown ends (max 100 characters)Happy New Year!
bgBackground color: hex without #, or transparent1a1a2e
fgText color, hex without #ffffff
themeColor preset (see below)neon
fontsans, serif, mono or display (system fonts), or one of the site’s own: montserrat, oswald, bebas, playfair, cinzel, grotesk, orbitron, fredoka, pacifico, caveatmono
bgimgBackground image, an HTTPS URL (URL-encoded)https://…
bgimgtallOptional second background image for screens taller than wide, such as a phone held upright. The ready-made pictures bring their own.https://…
styleLook of the countdown: big (one big number), ring, cards or glow. Leave it out for the classic look.ring
animHow a digit changes: fade, slide, flip, pop or blur. Leave it out for none.flip
unitsComma-separated time units (see below)d,h,m,s
hidezero1 leaves out the largest units once they read zero: no days in the last 24 hours, then no hours, and so on1
recurRepeat: daily, weekly, monthly or yearlyweekly
holdWith recur: how long the end message stays after each occurrence before it counts to the next one, as a number and m, h or d (minutes, hours, days). At most half the repeat: 12 hours for daily, 84 hours for weekly, 14 days for monthly, 182 days for yearly1d
soundSound at zero: chime or bellchime
celebrateAnimation at zero: confetti or fireworksconfetti
notifyBrowser notification at zero (1 to enable)1
showtzShow the time zone under the countdown (1)1
progressProgress bar (1, needs start)1
percentPercentage complete (1, needs start)1
startStart date for progress, ISO 86012026-01-01T00:00:00
redirectPage to open after the countdown ends (HTTPS)https://example.com/launch
redirectDelaySeconds to wait before redirecting (needs redirect)5
attribution0 hides the “Made with count.live” link0
embedMinimal embed view without buttons (1)1
shapeFor embeds made from the link itself (Canva, Notion): the frame’s proportions, banner (4:1), video (16:9), square or tall (9:16). Leave it out for 2:1. The countdown is scaled to fit the frame.tall
padIn an embed, scales the countdown to its frame: none right to the edges, small with a little space around it. Leave it out for the standard layout.small
labels0 hides the units’ names under the numbers0

Theme presets

Use theme= with one of: dark, light, neon, pastel, ocean, sunset, forest. Custom bg and fg colors are ignored when a theme is set.

Time units

UnitAccepted names
Yearsy, yr, yrs, years
Monthsmo, mon, months
Weeksw, wk, wks, weeks
Daysd, day, days
Hoursh, hr, hrs, hours
Minutesm, min, mins, minutes
Secondss, sec, secs, seconds
Millisecondsms, milliseconds

How units add up: the largest unit you choose shows its total, and each smaller unit shows what’s left after the larger ones. With only weeks and minutes, a 15-day countdown reads “2 weeks, 1440 minutes”, not “2 weeks, 30 minutes”.

When it reaches zero: the countdown ends at the exact target time. Hidden smaller units round up to the nearest unit you show, so with only minutes a countdown to 12:30:45 shows “1 minute” until 12:30:45, then the end message.

Precise time calculations

Years and months use real calendar dates, accounting for leap years and months of different lengths: from January 15 to March 15 is exactly 2 months, whether February has 28 or 29 days. Weeks, days, hours and smaller units are calculated from the time left after whole years and months, by the clock in the countdown’s time zone, so daylight-saving changes don’t make it read an hour off. How count.live counts down has the rounding rules and examples.

Dates and time zones

Supported date formats:

  • 2026-12-31T23:59:59-05:00: date, time and UTC offset (what the builder writes)
  • 2026-12-31T23:59:59: date and time
  • 2026-12-31T23:59: without seconds
  • 2026-12-31: date only, at midnight

Dates without an offset are read as UTC. A countdown always runs to one exact moment, so everyone who opens the link sees the same time remaining, wherever they are. To count down to a time in another city, pick that city’s time zone in the builder.

Repeating countdowns

With recur, a countdown restarts by itself: when it reaches zero it plays its celebration, works out the next occurrence in its time zone, and keeps counting. That makes it ideal for weekly meetings, a daily stream, birthdays and anniversaries. If a redirect is set, the redirect happens instead, except when the countdown is embedded.

Add hold to show the end message for a while first: with hold=1d a yearly birthday countdown shows “Happy birthday!” for the whole day, then starts counting to the next one. The builder offers it as Show the end message for, up to half the time between occurrences. Only daily, weekly, monthly and yearly repeat; any other recur is a one-time countdown.

Progress bar and percentage

Add progress=1 and/or percent=1 together with a start date to show how much of the time between start and date has passed.

Redirect when it ends

Set redirect to an HTTPS address to send visitors there when the countdown ends, for example to a product page at launch. redirectDelay waits a number of seconds first. Redirects are turned off when the countdown is embedded in another site.

Full URLs (starting with http:// or https://) in the title, subtitle and end message become clickable links automatically.

Embedding

Countdowns can be embedded anywhere that accepts iframes or rich embeds. Step-by-step guides: Canva, Notion, OBS and streaming, and websites (WordPress, Squarespace, Wix, Webflow, HTML).

  • embed=1 hides the buttons on the countdown page for a clean look; the builder’s embed code includes it.
  • All visual options (colors, theme, font, background image, units) work in embeds.
  • Embeds are responsive: the countdown scales to whatever size you give it.
  • bg=transparent gives a see-through background, for example for an OBS overlay or on top of a Canva design. The builder’s Transparent background option sets it. Opened on its own rather than embedded, a transparent countdown shows on a plain white page.
  • In Canva you can also use the count.live app (search for it under Apps): it has the same settings, keeps the countdown editable, and imports existing count.live links.

Feedback

Found a bug or missing an option? Email dev@count.live.