Telegram Countdown Bot: A Live Day Counter That Updates Itself
Group plans live and die by one question: "how long until X?" Someone posts a date in chat, everyone does mental math against today, and a week later nobody is sure whether the trip is in 9 days or 11. A pinned date solves nothing — pins don't count down. What the group actually needs is a message that answers the question for itself, every day, without anyone re-posting it.
CountdownDaysBot does exactly that. You give it a date and a label, it posts a card in the group — "22 days to Christmas" — and it edits that same card as the number changes, so the count is always current and the chat never fills up with re-posts. There are two ways to use it: inline, by typing @CountdownDaysBot plus a date in any chat, or by adding the bot to the group for recurring, self-editing countdowns.
This guide walks through both: the quick inline one-off card for a single announcement, and the full group setup for deadlines, launches, exams, trips, and release dates — plus the free-tier limits worth knowing before you rely on it.
Steps
- Post a one-off countdown card with inline mode (nothing to add). In any chat or group, type @CountdownDaysBot followed by a date and a label, like @CountdownDaysBot 2026-12-25 Christmas. A card appears showing how many days remain until that date. This posts once as a snapshot — the number is correct when posted, but the card does not keep editing itself. It's the zero-setup option: no bot in the group, no admin permissions, works even in chats where you can't add bots.
- Add the bot for self-editing countdowns. For a countdown that stays current on its own, add CountdownDaysBot to the group (it needs permission to post and edit its own messages; it doesn't need to read your chats). Then run /countdown 2026-12-25 Christmas. The bot posts one card and edits that same message whenever the day count changes — checked hourly, so the number updates roughly when you'd re-check it anyway, not on a noisy schedule.
- Set the group's time zone so the math is right. Day counts depend on what 'today' means. Run /ctz +2 (or whatever your group's UTC offset is) so the countdown flips at your local midnight, not UTC's. This matters most for the final days: with the right offset, "1 day to go" appears the evening before the event, matching what members actually expect. It's a one-time, per-group setting.
- Track everything with /countdowns and clean up with /stop. Run /countdowns to list every countdown running in the group with its target date and days remaining — useful once you have a few in flight. To retire one, use /stop with the countdown's id from that list, e.g. /stop 3. The creator can always stop their own countdown, and group admins can stop anyone's, so a departed member's stale countdown doesn't linger.
- Use it for the things groups actually count down to. The pattern fits any shared future date: a product launch, exam dates, a trip departure, a game's release day, the last day to submit a form, or the start of a recurring meeting's new season. Put the label to work — "/countdown 2026-11-01 Paper deadline" reads better in the card than a bare date, and the label is what members see every time they scroll past.
- Know the free limits before you build habits on it. Free groups can run 2 active countdowns at a time — enough for a launch plus a trip, not enough if the group tracks many dates. Pro removes the cap, adds a custom emoji to the countdown message, and switches the final 2 days to hourly-precision updates for a one-time 150 Stars payment per group. If you only ever need one or two, the free tier genuinely covers it.
Good to know
- The self-editing countdown checks hourly and only edits the card when the displayed number actually changes — so one edit per day for most of the run, more granular near the end on Pro.
- Inline one-off cards are snapshots: correct when posted, but they don't keep updating. The self-editing behavior requires the bot to be in the group.
- Each group's countdowns are stored per chat — target date, label, creator id, and the message id being edited. The bot doesn't read or store any other group messages.
- Stopped countdowns are marked stopped rather than deleted, so countdown ids stay consistent and /countdowns stays readable.
- Free = 2 active countdowns per group. Pro = unlimited, custom emoji, and hourly-precision updates in the final 2 days, one-time 150 Stars per group.
FAQ
- How does a countdown bot work in a Telegram group?
- You give CountdownDaysBot a date and a label with /countdown. It posts a card in the group showing the days remaining and edits that same message as the number changes — checked hourly — so the count is always current without anyone re-posting.
- Can I use a countdown bot without adding it to the group?
- Yes. Type @CountdownDaysBot followed by a date and label in any chat and it posts a one-off countdown card via inline mode. The card is a snapshot, though — for a countdown that keeps updating itself, add the bot to the group.
- How many countdowns can a group have?
- Free groups get 2 active countdowns at a time. Pro removes the cap (unlimited countdowns, custom emoji, hourly precision in the final 2 days) for a one-time 150 Stars payment per group — not a subscription.
- Who can stop or delete a countdown?
- The member who created it, or any group admin, can stop it with /stop and the countdown's id from /countdowns. Stopping marks it ended rather than deleting it, keeping ids consistent.