For the complete documentation index, see llms.txt. This page is also available as Markdown.

Schedule badge visibility

Schedule when a badge appears and disappears, restrict it to recurring weekday time windows, and add a countdown to the end time.

Use Visibility Date & Countdown to control the overall period when a badge can appear. For recurring campaigns, you can also limit the badge to selected weekdays and a specific time window on those days.

Schedule a badge

1

Open the badge editor

In Sami Product Labels, open Badges & Labels, then create a badge or click Edit badge/label for an existing one.

2

Open Visibility Date & Countdown

Select the Display tab, then expand Visibility Date & Countdown.

Visibility Date and Countdown section expanded in the Display tab
Open Display > Visibility Date & Countdown to configure the overall visibility period.
3

Set the start date and time

Click Start, select a date in the calendar, then choose the Hours and Minutes. The badge remains hidden until this time.

The field uses the format YYYY-MM-DD HH:mm.

Start date picker with calendar, Hours, and Minutes controls
Select the date, hour, and minute when the badge should start appearing.
4

Set the end date and time

Click End and select the date, Hours, and Minutes when the badge should stop appearing. The End time must be later than the Start time.

End date picker with calendar, Hours, and Minutes controls
Select when the badge should stop appearing on the storefront.
5

Optional: add a recurring weekday schedule

Enable Daily recurring timer when the badge should appear only on certain days and during the same time window on each selected day.

  1. Under Weekday, keep the days when the badge should appear and clear the other days. All seven days are selected by default.

  2. Under Start time, enter the Hours, Minutes, and Seconds when the daily window begins.

  3. Under End time, enter the Hours, Minutes, and Seconds when the daily window ends.

The recurring weekday and time rules apply inside the overall Start and End visibility period. For example, a Monday-to-Friday window from 09:00:00 to 11:00:00 displays the badge only during those hours on those weekdays, and only while the overall date range is active.

Daily recurring timer with weekday selection and Start time and End time fields
Select the active weekdays and set one recurring time window shared by those days.
6

Choose a status and save

Choose Active to make the badge eligible to appear according to the schedule, or Draft to keep it hidden. Click Save to apply the configuration.

Add a countdown to a text badge

The countdown is separate from the visibility controls. Visibility Date & Countdown defines the schedule, while the {countdown} variable renders the remaining time inside a text badge.

  1. Make sure the badge has a valid End date and time. The countdown counts down to this value.

  2. Return to Design, expand Content, and click Insert Dynamic Text in the Badge text toolbar.

  3. Find {countdown}, choose Style 1 or Style 2, then click Copy.

  4. Paste the copied token into the Badge text editor, preview the result, and save the badge.

Countdown variable with Style 1 and Style 2 options in Insert Dynamic Text
Choose a countdown style, copy the generated token, and paste it into the badge text.

For the complete variable workflow, see Dynamic Variables.

How the visibility rules work together

Configuration
When the badge can appear

Start and End only

At any time inside the overall date and time range

Start, End, and Daily recurring timer

Inside the overall range, on a selected weekday, and inside the recurring daily time window

Draft status

Never, even when the schedule matches

Active status

When the schedule and all other product and display conditions match

The overall Start and End pickers use minute precision. The recurring Start time and End time fields also include seconds.

Next steps

  • Dynamic Variables — Insert {countdown} and other live values into a text badge.

  • Target Products — Choose which products are eligible to display the scheduled badge.

Last updated

Was this helpful?