# Countdown timers

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
<img
  src="https://countdown.plandalf.dev/acme/promo/early-bird.gif?pf_ref={{subscriber.email}}"
  alt="Time left"
>
```

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

## Related docs

-   [Create a promo](https://plandalf.com/docs/product-guides/promos/create-promo)
-   [Tiers and timing](https://plandalf.com/docs/product-guides/promos/tiers)
-   [CTA links and redirects](https://plandalf.com/docs/product-guides/promos/cta-links)

Source: https://plandalf.com/docs/product-guides/promos/countdowns