For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Countdown timer

Run a live countdown in banners, the announcement bar, popups, and on product pages. Set the end date, choose what happens at zero, and target single products.

A visible deadline is one of the cheapest ways to move a hesitant visitor. In Avante the countdown is a block, not a section, so the same timer can run inside a hero banner, in the announcement bar, in a popup, or right above the Add to cart button — wherever the offer actually lives.

The block counts down in days, hours, minutes, and seconds, and you decide what the storefront shows once the clock reaches zero.


Where you can add it

The Countdown timer block is available in these sections:

Section
Group

Media with text

Newsletter

Global sections

Global sections

Global sections

Product overview, on any product template

Featured product

Products

Quick view

Products

In Slideshow with media the countdown belongs to the slide rather than to the section, so one sale slide can run a timer while the rest stay evergreen.


Adding the block

1

Open the section

In the Theme Editor, select the section that should carry the timer.

2

Add the block

Click Add block and choose Countdown timer. Drag it into place — above the buttons in a banner, under the price on a product page.

3

Set the deadline

Fill in End date, and End time if the offer ends at a particular hour.

4

Choose what happens at zero

Pick an option under When the expiration date and time pass, write a Complete message if you need one, then Save.


Setting the deadline

End date uses the YYYY-MM-DD format — 2026-12-24, not 24/12/2026.

End time is optional and uses HH:MM in 24-hour form. Leave it empty and the timer ends at 00:00, the first minute of the day you entered — so a sale that should run through Christmas Eve needs 2026-12-25, or 2026-12-24 with an end time of 23:59.

The end date has to be within 99 days. The days field holds two digits, so anything further out is rejected and the timer does not run. For long campaigns, set the timer when the final stretch begins.

Both fields are validated strictly. A date in the wrong format, an impossible date such as 2026-02-30, or a date more than 99 days away all count as invalid.


When the timer runs out

When the expiration date and time pass has four options:

Option
What the customer sees

Hide the timer

The timer disappears. Nothing replaces it.

Show zeros

The timer freezes at 00 : 00 : 00 : 00.

Show message

The timer is replaced by your Complete message.

Show zeros and message

The frozen timer stays and the Complete message appears next to it.

The Complete message is a rich text field, so it can hold a link — useful for sending latecomers to a collection that is still live.


Showing a timer on specific products only

A block added to the Default product template appears on every product that uses it. To run a timer on a handful of products, give those products their own template.

1

Create a product template

In the Theme Editor, open the template selector at the top, go to Products → Default product, and choose Create template. Name it something recognisable, such as sale.

2

Add the countdown

In the new template, add the Countdown timer block to the Product overview section and set the end date.

3

Assign the template to the products

In Shopify Admin → Products, open each product and pick the new template under Theme template. You can do this for many products at once by selecting them in the product list and using Bulk edit.

The theme editor repeats this in the block description: to show a countdown timer on specific products, create a product template with the timer and assign it to those products.


The timer in Quick view

The Quick view countdown behaves differently on purpose. Its block has no date fields — it reads the end date, end time, and complete message from the Countdown timer block in that product's own template, so a quick view opened from a collection page shows exactly the same deadline as the product page.

What the Quick view block does control is its own styling and its When the expiration date and time pass option.

If a product's template has no Countdown timer block, the Quick view timer has nothing to read and removes itself. That is the intended behaviour: products without a sale template simply show no timer.


Good to know

The theme editor and the live store react differently to a bad date. With an invalid or out-of-range date, the editor keeps the timer visible and frozen at zeros so you can see the block and fix it. On the live storefront the same block is removed entirely. Always check a new timer on the published store, not only in the editor.

Hiding the timer can take the rest of the section with it. When the countdown is the only block in a Rich text, Image banner, Newsletter, Video banner, or Media with text section — or the only block on an announcement bar or slideshow slide — hiding it leaves an empty content area, so the theme removes that area too. A typo in the end date can therefore blank out a banner. Keep at least a heading or a button alongside the timer if the section must stay visible.

The timer updates live. It ticks down in the customer's browser without a page reload, and the expiration action fires the moment the clock reaches zero.


Customization ideas

Pair it with the announcement bar for a store-wide sale. One timer at the very top of every page carries the deadline through the whole visit, while the product page timer repeats it where the decision is made.

Use the Complete message as a second offer. Instead of "This offer has ended", link to the next promotion: "Sale closed — see what's new".

Match the timer to the banner. The block has its own text colour, text size, optional background with colour or gradient, corner radius, and outline, so it can sit on a photo without a panel behind it, or stand out as a bold badge.

Turn labels off for a compact look. Show labels hides the Day / Hr / Min / Sec captions and leaves only the digits — cleaner in a narrow column.


Best practices

Use a deadline that is real. A timer that resets every day teaches customers to ignore it.

Give the countdown a reason next to it. "Ends in" above the digits converts better than four numbers on their own.

Decide what happens after zero before you publish. Hide the timer is the safe default when the section has other content; Show message is better when the block is carrying the whole promotion.

Check the timer on mobile. Four pairs of digits plus labels need room, and a long complete message wraps differently on a phone.


Was this helpful?