# Timers and promos overview
Use Plandalf timers and promos to coordinate deadline campaigns across pages, emails, CTA links, and checkout prices.
Source: /docs/timers/overview
Last modified: 2026-06-19
Timers are not just visual countdown widgets. In Plandalf, a promo is campaign state: deadline, active tier, CTA target, redirect behavior, buyer reference, and checkout pricing context.


### Promo campaign path

A promo ties the campaign link, countdown, and checkout price together so the customer sees one consistent offer.

- [Email or ad click](/docs/timers/cta-links) - The visitor arrives with `pf_ref` so campaign and participant context can follow them.
- [Countdown renders](/docs/timers/countdowns) - The page or email shows the current deadline state from the promo.
- [Checkout uses active tier](/docs/timers/tiers) - The checkout button passes the promo slug so the active tier can affect pricing or redirects.

## What promos control

- launch windows and deadline funnels
- active tier names, times, and prices
- countdown displays on pages
- email countdown image URLs
- CTA links and redirects
- checkout pricing when an offer is opened with a promo
- reporting for participants and campaign outcomes

## Page widget

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

## Checkout pricing context

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

Programmatic equivalent:

```js
await plandalf.present("summit-ticket", {
  promo: "early-bird"
});
```

## Related docs


### [Create a promo](/docs/timers/create-promo)


    Set up the campaign record that drives tiers, widgets, and checkout pricing.


### [Countdown timers](/docs/timers/countdowns)


    Add visual countdown surfaces to pages and email.


### [CTA links](/docs/timers/cta-links)


    Keep campaign links and redirects aligned with active tiers.


### [Embedded promos](/docs/timers/embedded-promos)


    Pair a promo with an embedded offer.