Using it

Sponsor slots and pools

A sponsor slot is one paid ad that replaces the billboard's playlist until it expires.

/ha sponsor assign <billboard> <media> <days>
/ha sponsor clear <billboard>
/ha sponsor list

Use 0 days for no expiry. Assigning a slot resets that billboard's analytics. When a slot expires, sponsors.expiry-behavior decides what happens: VACANT_MEDIA shows the media named in sponsors.vacant-media, REMOVE drops the entry from the playlist, and KEEP keeps the last ad.

A pool is a group of billboards that rotate through one shared list of ads. Manage them in the GUI (Main Menu, Sponsor Pools) or with commands:

/ha pool create <pool>
/ha pool add <pool> <billboard>
/ha pool remove <pool> <billboard>
/ha pool info <pool>
/ha pool delete <pool>

Ads inside a pool are added and edited in the GUI.

Per-ad limits#

Click an ad in the pool to set its limits: max plays, max clicks, max airtime (such as 30m or 2h) and an expiry (such as 7d, or a date). When any limit is reached the ad leaves the rotation. A play limit lets the last run finish. Plays, clicks and airtime show as progress bars. You can pause an ad, or reset its counters so it plays again. 0 means no limit.

Campaign#

In Pool Settings you can give the whole pool a start and end time, such as 2h, 3d or 2026-11-02 18:00.

When nothing plays#

Used when the pool is paused, before the start, after the end, or when every ad is finished:

  • FALLBACK shows a fallback image or video you pick, such as an "Advertise here!" banner.
  • BILLBOARD lets each screen play its own media.
  • HIDE leaves the screens blank.

Rotation#

Choose whether every screen shows the same ad at the same time (synchronized) or each advances on its own, whether to move on when a clip ends or on a timer, and whether to play in order or shuffled. Counters are saved every 30 seconds and on shutdown.