> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Honest countdowns

> Countdowns that follow the real end of your offer, written in ISO 8601 with a time zone offset, and disappear at zero.

Gloaming has four countdowns, all off until you type an end date:

* the Sale countdown section on the home page;
* an optional countdown on each announcement in the Announcement bar;
* a Sale end countdown in the product page's Price block, shown only on sale prices;
* the opening countdown on the Password page.

**Write the date like this.** Year, month, day, the letter T, the time in 24 hours, then the time zone offset:

* 2026-11-30T23:59-05:00 is 11:59 pm on 30 November in New York (Eastern time);
* 2026-11-30T23:59+01:00 is 11:59 pm on 30 November in Paris (Central European time);
* 2026-11-30T23:59Z is 11:59 pm on 30 November in UTC.

Seconds are optional. The offset is required: a date without it is treated as unreadable.

**Match your discount.** Use the same moment as the end date of the discount in Shopify, in the same time zone, so the countdown and the offer end together.

**What happens.**

* A date the theme cannot read, or one that has passed, hides the countdown.
* At zero the countdown removes itself. It never restarts for a new visitor.
* With Hide the section after the end date on (Sale countdown), the whole section disappears once the end has passed, so shoppers never see sale copy after the offer. The theme editor keeps showing it.
* Screen readers hear the time left at most once a minute, not every second.

![The sale countdown](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/sale-countdown.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=79ac39504a56a390554d190cd32cd12d)

The sale countdown on the home page

> [!NOTE]
>
> Countdowns must follow a real deadline. Do not move the date forward to keep a countdown running; the theme is built so that it cannot restart on its own.

## In the theme editor

![Sale countdown in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-sale-countdown.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=690b6eae178658c500064132291a96c3)

1 Sale countdown · 2 its settings, with Sale ends in ISO 8601 · 3 the preview

![Announcement bar in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-announcement-bar.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=b04217e7ee02c0578ec485a7eb347af2)

The announcement bar countdown is set on each Announcement block: 1 Announcement bar · 2 its settings · 3 the preview


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.