# Countdown

> A countdown to a date you set, as a bar, banner or image.

Source: https://spellnsell.com/themes/kera/docs/reference/sections/countdown · Kera 1.0.0 · Updated 2026-11-16

A countdown to a date you set, as a bar, banner or image.

- **Where it can go:** Any page
- **Area:** Home and storytelling
- **File:** `sections/countdown.liquid`

## Section settings

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Layout** | Choice | Image with text | Options: Bar, Image with text, Banner. |
| **Image** | Image |  |  |
| **Image position** | Choice | Left | Options: Left, Right. |
| **Color scheme** | Color scheme | Scheme 2 |  |

### End date

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **End date** | Text |  | Format YYYY-MM-DD, for example 2026-12-31. The countdown is the same for every customer and ends at this moment in your store's time zone. |
| **End time** | Text | 23:59 | 24-hour clock, format HH:MM, for example 18:00. Leave empty for 00:00. |
| **When the countdown ends** | Choice | Hide section | Options: Hide section, Show a message. |
| **Message** | Text | The sale has ended. Thank you for shopping with us. |  |

### Content

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Eyebrow** | Text | Sale ends in | In the bar layout, the label before the timer. |
| **Heading** | Text | Count down to your sale |  |
| **Text** | Rich text |  |  |
| **Button label** | Text | Shop the sale |  |
| **Link** | Link |  |  |

### Section spacing

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Top spacing** | Choice | None | Options: None, Small, Medium, Large. |
| **Bottom spacing** | Choice | None | Options: None, Small, Medium, Large. |


## Developer notes

Countdown to an end date the merchant sets, the same moment for every visitor: it never restarts. Layouts: bar, image, banner. The end date and time are read in the store's time zone: the store's UTC offset on that date (date: '%z') is added to make an ISO timestamp for assets/countdown.js. A date or time in the wrong format shows nothing on the storefront and a hint in the editor. Once the end has passed, at render or while the page is open, the section hides or shows the "finished" message; in the editor a hidden section stays, with a note.
