Countdown Timer User Guide

What it does

The Countdown Timer shows a live, ticking countdown to a deadline — the end of a sale, the close of a pre-order window, the launch of a new drop. A visible clock creates urgency, and urgency converts.

It’s a Free module with no licence and no database tables. The timer renders as clean HTML with a tiny, self-contained script, so it works on any theme and has no dependencies. With JavaScript switched off it still shows — it just doesn’t tick — and when the deadline passes it hides itself and shows your “offer ended” message.

Two ways to use it

There are two independent ways to put a countdown on your storefront. Use either or both.

1. Automatic product-page timer. Any product with a scheduled special-price end date shows a countdown on its detail page — no placement work needed. Great for “sale ends in…” on discounted items.
2. Placeable widget. Drop a countdown anywhere — a CMS page, a static block, or a layout position — with an end date you choose. Great for site-wide campaigns and landing pages.

Product-page countdowns

When Show on Product is on, any product whose special price has a future end date (“Special Price To Date” on the product) automatically displays a countdown to that date on its page, just below the price.

To use it: set a Special Price on a product and give it a “To Date” in the future. That’s all — the countdown appears and counts down to the moment the discount ends. No rule to write, no block to place.

Tip. The countdown follows the special-price schedule exactly, so the clock and the actual discount always agree.

The countdown widget

For campaigns that aren’t tied to a single product, use the CPS Countdown Timer widget. Insert it like any Magento widget — on a CMS page or block, or via a layout position — and set:

Building the page in Lurox? Drop the widget into any Raw HTML or CMS area — it renders standalone, with or without a Lurox theme.

Display styles & labels

Two display styles ship in the box:

• Expanded — labelled boxes for days, hours, minutes and seconds. Bold and prominent.
• Compact — a tidy inline timer for tight spaces.

The unit labels (Days / Hours / Minutes / Seconds) are all editable, so you can localise or shorten them (e.g. “D / H / M / S”). When the deadline is reached, the timer is replaced by your configurable Expired Text (default “This offer has ended”).

Configuration

Stores → Configuration → Cabbage Patch Studios → Storefront: Countdown Timer.

Every setting is scope-aware (default / website / store), so a campaign style can differ per store.

Setting up & checking it works

1. Open Storefront: Countdown Timer and set Enable to Yes for the store you want.
2. For product timers, leave Show on Product on, then give a product a Special Price with a future To Date and view its page.
3. For a campaign timer, add the CPS Countdown Timer widget to a CMS page and set an End Date a few minutes out.
4. Load the page — the timer should tick down second by second.
5. To confirm the expired state, set an end date in the past: the timer should hide and show your Expired Text.

FAQ

Which time zone does it use? Dates follow your store’s configured time zone, the same as the rest of Magento.

Does it slow the page down? No. The timer is a few lines of self-contained script with no external libraries.

What if a customer has JavaScript off? The timer still renders; it just doesn’t animate. Nothing breaks.

Can I run several at once? Yes — the automatic product timer and any number of widgets can all appear together.