Scheduling
Show or hide a badge automatically between a start and end date, without having to enable or disable it manually.
Scheduling lets a badge appear and disappear on its own, without you needing to enable or disable it by hand. You set the schedule from the Advanced tab of the badge form, in the Schedule card.
This feature is plan-gated under badges_scheduling. If your plan does not include scheduling, the Schedule card shows an upgrade prompt instead of the date fields.
Schedule modes
The Schedule card has two modes, picked with a toggle:
- Always (default) — the badge displays continuously, with no time-based gating.
- Scheduled — the badge only displays inside a date and time window.
Configuring a scheduled badge
When you switch to Scheduled, two datetime fields appear:
- Start date. The badge starts showing at this date and time. Leave it empty to have no lower bound (the badge shows immediately, up to the end date).
- End date. The badge stops showing at this date and time. Leave it empty to have no upper bound (the badge shows from the start date onward).
You can set just one of the two if you only need a one-sided window:
- Start date only: the badge starts on the chosen date and stays visible.
- End date only: the badge is visible immediately and disappears at the end date.
- Both: the badge appears only inside the window you defined.
Dates are interpreted in your store's timezone.
How scheduling interacts with the rest
Scheduling is evaluated alongside the other badge rules:
- Before the start date, the badge is hidden regardless of targeting or conditions.
- During the window, the badge is shown only if it also passes targeting and any visibility conditions you set.
- After the end date, the badge is hidden.
For example, you can schedule a SALE badge for a weekend campaign (Saturday 00:00 to Sunday 23:59) targeted at a Sale collection, with a cart condition that requires the cart total to be over a threshold. The badge only appears for shoppers who meet all three criteria, only during that weekend.
Tips
- Schedule promotional badges (SALE, BLACK FRIDAY) ahead of time so they switch on and off automatically.
- Use a start date with no end date for evergreen badges that should switch on at a known date (a product launch).
- Use an end date with no start date for limited-time badges that should disappear after a deadline (a flash sale).
Last updated 1 day ago
Built with Documentation.AI