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.