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:00orZ); 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
tzwith an IANA name such asEurope/Madridwhen 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
1and left out otherwise. - Lengths: title up to 50 characters, subtitle up to 200, end message up to 100.
Every parameter
| Parameter | What it does | Example |
|---|---|---|
date | Target 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 |
tz | IANA time zone the countdown belongs to. Used for repeating countdowns and calendar math, and shown with showtz=1. | America/Los_Angeles |
title | Event title (max 50 characters) | New Year |
subtitle | Subtitle text, can span several lines (max 200 characters) | The countdown begins |
end | Message shown when the countdown ends (max 100 characters) | Happy New Year! |
bg | Background color: hex without #, or transparent | 1a1a2e |
fg | Text color, hex without # | ffffff |
theme | Color preset (see below) | neon |
font | sans, serif, mono or display | mono |
bgimg | Background image, an HTTPS URL (URL-encoded) | https://… |
bgimgtall | Optional second background image for screens taller than wide, such as a phone held upright. The ready-made pictures bring their own. | https://… |
style | Look of the countdown: big (one big number), ring, cards or glow. Leave it out for the classic look. | ring |
units | Comma-separated time units (see below) | d,h,m,s |
hidezero | 1 leaves out the largest units once they read zero: no days in the last 24 hours, then no hours, and so on | 1 |
recur | Repeat: daily, weekly, monthly or yearly | weekly |
hold | With 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 yearly | 1d |
sound | Sound at zero: chime or bell | chime |
celebrate | Animation at zero: confetti or fireworks | confetti |
notify | Browser notification at zero (1 to enable) | 1 |
showtz | Show the time zone under the countdown (1) | 1 |
progress | Progress bar (1, needs start) | 1 |
percent | Percentage complete (1, needs start) | 1 |
start | Start date for progress, ISO 8601 | 2026-01-01T00:00:00 |
redirect | Page to open after the countdown ends (HTTPS) | https://example.com/launch |
redirectDelay | Seconds to wait before redirecting (needs redirect) | 5 |
attribution | 0 hides the “Made with count.live” link | 0 |
embed | Minimal embed view without buttons (1) | 1 |
lang | Language 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&title=New%20Year&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.