Sponsor slots and pools
Sponsor slots (one ad per billboard)#
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.
Sponsor pools (many billboards, one shared list)#
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:
FALLBACKshows a fallback image or video you pick, such as an "Advertise here!" banner.BILLBOARDlets each screen play its own media.HIDEleaves 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.