Create a promo

Create a deadline promo that can drive countdowns, active tiers, redirect targets, and checkout price changes.

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.

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

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

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

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

Builder context

Timers are not just visual countdowns. The related product surfaces keep promo styling, coupons, deadline state, and checkout behavior connected.