# Timers and promos overview

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](https://plandalf.com/docs/product-guides/promos/cta-links) — The visitor arrives with pf_ref so campaign and participant context can follow them.

- [Countdown renders](https://plandalf.com/docs/product-guides/promos/countdowns) — The page or email shows the current deadline state from the promo.

- [Checkout uses active tier](https://plandalf.com/docs/product-guides/promos/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](https://plandalf.com/docs/product-guides/promos/create-promo) — Set up the campaign record that drives tiers, widgets, and checkout pricing.

- [Countdown timers](https://plandalf.com/docs/product-guides/promos/countdowns) — Add visual countdown surfaces to pages and email.

- [CTA links](https://plandalf.com/docs/product-guides/promos/cta-links) — Keep campaign links and redirects aligned with active tiers.

- [Embedded promos](https://plandalf.com/docs/product-guides/promos/embedded-promos) — Pair a promo with an embedded offer.

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