> ## 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.

# Sale countdown

> A sale edit with a countdown to the real end of your discount and the pieces in the sale. Off until you set an end date.

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

Sale countdown, highlighted with the demo content

## Where to find it

Home page. In the theme editor choose Home page, then select Sale countdown.

## How it works

* The countdown runs to the date in Sale ends, written with a time zone offset, for example 2026-11-30T23:59-05:00.
* A date the theme cannot read, or one that has passed, hides the countdown. It removes itself at zero and never restarts.
* With Hide the section after the end date on (the default), the whole section disappears once the end has passed, so shoppers never see sale copy after the offer. The theme editor keeps showing it so you can edit it.
* Below the countdown, 2 to 8 products from the chosen collection show with their sale prices.
* The section uses the Velvet color scheme (scheme 2) by default.

![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)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Create the discount in Shopify first, or set compare-at prices on the pieces.
* Type the discount's end in Sale ends, using the same moment as the discount's end date in Shopify.
* Choose the Collection of sale pieces and set Products to show.
* Edit Eyebrow, Heading, Text, Countdown label and the link.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 2. |
| **Eyebrow** | Text. Default: The salon edit. |
| **Heading** | Text. Default: The winter salon edit. |
| **Text** | Formatted text (one line). |

**Countdown**

| Setting | What it does |
| - | - |
| **Sale ends** | Text. The real end of your Shopify discount: date, time and time zone offset, such as 2026-11-30T23:59-05:00. Use the same moment as the discount's end date in Shopify. Leave it empty for no countdown. A date the theme cannot read, or one that has passed, hides the countdown, and it never restarts. |
| **Countdown label** | Text. Default: The edit ends in. |
| **Hide the section after the end date** | On or off. The countdown always disappears at zero. With this on, the whole section goes too, so shoppers are not shown sale copy after the discount has ended. The theme editor keeps showing it. Default: on. |

**Products**

| Setting | What it does |
| - | - |
| **Collection** | Choose a collection. The pieces in the sale. Their sale prices come from compare-at prices or your discount. |
| **Products to show** | Slider from 2 to 8. Default: 4. |
| **Link label** | Text. Default: Shop the edit. |
| **Link** | Link: a page, product, collection or web address. Defaults to the collection. |

> [!NOTE]
>
> The theme ships with no end date, so there is no countdown on install. See [Honest countdowns](https://docs.kwebby.com/gloaming/guides/honest-countdowns.md).


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