The shape of a link

A countdown link is https://count.live/? followed by name=value pairs joined with &. Only date is required:

https://count.live/?date=2027-01-01T00:00:00-05:00

Nothing is stored on a server and there is no API key or account: opening the link is what creates the countdown. The same link works in a browser, in an iframe, in Canva and Notion, and in the count.live apps. Parameters can come in any order, unknown parameters are ignored, and a link never expires.

Rules

  • Dates are ISO 8601: 2027-01-01T00:00:00-05:00. Always include the UTC offset (-05:00, +01:00 or Z); without one the time is read as UTC. A date without a time, 2027-01-01, is midnight UTC.
  • One moment for everyone: a countdown runs to one exact instant, so every visitor sees the same time remaining wherever they are.
  • Time zone: add tz with an IANA name such as Europe/Madrid when the countdown repeats or shows months and years, so calendar math follows that place’s clock and daylight saving time.
  • Encoding: percent-encode values. A space is %20, / in a time zone is %2F, + in an offset is %2B, and & inside a title is %26. Colons in the date may stay as they are.
  • Colors are six-digit hex without the #: bg=1a1a2e.
  • On/off options are turned on with 1 and left out otherwise.
  • Lengths: title up to 50 characters, subtitle up to 200, end message up to 100.

Every parameter

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 displaymono
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
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
langLanguage of the unit labels and buttons: es or pt (English when left out)es

Units for units: y years, mo months, w weeks, d days, h hours, m minutes, s seconds, ms milliseconds, separated by commas. The default is d,h,m,s. Themes for theme: dark, light, neon, pastel, ocean, sunset, forest. How each option behaves is explained in the documentation.

Complete examples

A date and a title

https://count.live/?date=2027-06-12T16:00:00-04:00&title=Our%20wedding&tz=America%2FNew_York

Counts down to 4:00 p.m. on June 12, 2027 in New York, for everyone who opens it.

A birthday that repeats every year

https://count.live/?date=2027-03-09T00:00:00-06:00&title=Maya%27s%20birthday&recur=yearly&tz=America%2FChicago&celebrate=confetti

Restarts by itself after each birthday and shows confetti at zero.

Days only, in your own colors

https://count.live/?date=2027-12-25&title=Christmas&units=d&bg=0f3d2e&fg=ffffff&font=serif

A date without a time is midnight UTC; add a time and offset to count to midnight somewhere else.

A progress bar between two dates

https://count.live/?date=2027-05-28T15:00:00-04:00&start=2026-08-31T08:00:00-04:00&title=Last%20day%20of%20school&progress=1&percent=1

Shows how much of the school year has passed, as a bar and a percentage.

An embed with a transparent background

https://count.live/?date=2027-01-01T00:00:00-05:00&title=Stream%20starts&units=h,m,s&bg=transparent&fg=ffffff&embed=1

For an iframe, an OBS browser source or a Canva design: no buttons, and only the text is drawn.

Embedding a link

Add embed=1 and put the link in an iframe. The countdown scales to the size you give it:

<iframe src="https://count.live/?date=2027-01-01T00:00:00-05:00&amp;title=New%20Year&amp;embed=1" width="600" height="300" style="border:0" title="Countdown"></iframe>

Embedded countdowns show no ads and set no cookies. Guides: websites, Canva, Notion, OBS.

For AI assistants and scripts

To make a countdown for someone, build the link from the rules above and give it to them; there is nothing to call and nothing to sign up for. Use the person’s own time zone for the offset and tz, keep the title short, and add recur=yearly for birthdays and anniversaries. A plain-text summary of this page is at count.live/llms.txt. To change a countdown later, edit the link, or open it and choose Edit.

Frequently asked questions

Do I need an API key or an account to create a countdown link?

No. A countdown is just a link: write the address with a date parameter and it works. Nothing is stored on a server.

Which parameter is required?

Only date, in ISO 8601 format with a UTC offset, for example 2027-01-01T00:00:00-05:00. Everything else is optional.

Do countdown links expire?

No. A link keeps working after the countdown ends: it shows the end message, or starts again if it repeats.