# Create a promo
Create a deadline promo that can drive countdowns, active tiers, redirect targets, and checkout price changes.
Source: /docs/timers/create-promo
Last modified: 2026-06-18
A promo is the campaign record behind timer surfaces and promo-aware checkout.

## Setup steps


### Create the promo


    Give the campaign a slug such as `early-bird`, `black-friday`, or `launch-window`.


### Choose the type


    Configure fixed dates, evergreen timing, quantity windows, or tiered campaign phases where supported.


### Define tiers


    Add the active windows, labels, prices, coupons, or redirect targets for each phase.


### Connect the offer


    Choose the Plandalf offer and prices the promo should affect.


### Publish widgets and links


    Add countdown widgets, CTA links, hosted landing pages, or embedded checkout buttons.


## Apply to checkout

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

## Read promo state

Use `plandalf.promo(slug)` to read the current promo state from your storefront code.

```js
const promo = await plandalf.promo("early-bird");

if (promo) {
  console.log(promo.active_tier);
}
```

## Related docs

- [Pricing models](/docs/offers/pricing)
- [Countdown timers](/docs/timers/countdowns)
- [Embedded promos](/docs/timers/embedded-promos)