# Countdown timers
Embed countdown timers on pages and in email while keeping the timer connected to the campaign state.
Source: /docs/timers/countdowns
Last modified: 2026-06-18
Countdowns show the active deadline for a promo. Use them to make the same campaign state visible on landing pages, sales pages, and emails.

## Page countdown

```html
<div data-plandalf-promo="early-bird"></div>
```

The SDK scans the page and mounts the promo widget into that element.

## Pair with a checkout button

```html
<div data-plandalf-promo="early-bird"></div>

<button
  data-plandalf-present="summit-ticket"
  data-plandalf-apply-promo="early-bird"
>
  Buy before the deadline
</button>
```

The first element renders the countdown. The button opens the offer and applies active promo-tier pricing.

## Email countdowns

Email clients cannot run JavaScript, so email countdowns use an image URL generated by the countdown service.

```html
![Time left](https://countdown.plandalf.com/img?promo=early-bird&pf_ref={{subscriber.email}}&org=pk_live_...)
```

Use `pf_ref` for participant tracking in links and countdown image URLs.

## Related docs

- [Create a promo](/docs/timers/create-promo)
- [Tiers and timing](/docs/timers/tiers)
- [CTA links and redirects](/docs/timers/cta-links)