Skip to content

The campaign editor

The campaign editor is where you build a campaign: choose a template, add your content, set a schedule, pick the screens, and launch. It is one long form organized into four numbered steps you expand one at a time.

You reach the editor by creating a campaign (+ Campaign on the Campaigns screen), by choosing Edit on a campaign’s card menu, or with the EDIT button on a campaign’s detail page. The editor lives at /campaigns/{id}/edit, and that URL survives a page refresh.

Across the top of the editor you have:

  • An editable title — click it and type to rename the campaign inline.
  • The status badge — the campaign’s current status.
  • SAVE — stores your changes as a draft (see SAVE vs START).
  • — leaves the editor, returning to wherever you opened it from.
The editor header and step 1 — title, status, SAVE, and the four numbered steps below
The campaign editor: an editable title, a Draft status pill, a SAVE button, and step 1 Create content expanded with a template card

The four steps are Create content, Set schedule, Choose places, and Launch campaign. Work through them in order.

This is where the campaign’s look and its media come together.

A template defines the on-screen layout — one full-screen zone, or several zones (for example, a video area plus a ticker). Click the template card to open the template picker and choose one. Picking a template lays out its zones ready for content.

The template picker — choose the on-screen layout
The template picker dialog open over the editor, listing available templates

A template can own several scenes — each scene is a different zone layout the same template offers. When a template has more than one scene, a scenes dropdown appears; pick the one you want. A campaign plays exactly one scene.

The scenes dropdown — a template can offer several layouts; a campaign uses one
The scenes dropdown open, listing the scenes a multi-scene template offers

For a multi-zone template, the editor draws the layout as a canvas. Click a zone to make it active; a strip of zone tabs lets you switch between them. Whatever you do next (add content, set rules) applies to the active zone.

A multi-zone layout — click a zone to make it active
A multi-zone template canvas with one zone active and a zone tab strip

With a zone active, click the Add button. It offers three sources:

  • From content storage — pick from your existing content.
  • From a playlist — insert a whole playlist at once.
  • File from device — upload a new file straight into the zone.
Add content — from storage, from a playlist, or a fresh upload
The Add menu open with From content storage, From a playlist, and File from device
From content storage — pick the files to add to the zone
The content picker showing the workspace's media files to add to the zone
From a playlist — drop a whole reusable list into the zone
The playlist picker listing the workspace's reusable playlists

Each item has a Rules action opening a dialog where you control when and how that item plays:

  • Validity — unlimited, or a start/end date range.
  • Days of the week and time of day — all day, or a time window.
  • Play duration — how long the item shows (see the caution below).
  • Rotation — 0°, 90°, 180°, or 270°, for screens mounted in a fixed orientation.
  • Scale / fit — how the item fills the zone (Auto, and other fit modes).
  • Interruption allowed — whether a higher-priority item may interrupt this one.
The Rules dialog — validity, weekdays, and time windows
The playback rules dialog: validity dates, weekday chips, and time-of-day windows
The Rules dialog, lower half — play duration, rotation, scale, audience (disabled), interruption
The playback rules dialog scrolled to show rotation chips, scale mode, the disabled audience section, and the interruption toggle

Each item row has an overflow (⋮) menu with Preview, Duplicate, Rules, and Delete. On a multi-zone campaign, a separate Copy to zone… button on the row copies the item into another zone.

The item row menu — Preview, Duplicate, Rules, and Delete (Copy to zone is a separate button on the row)
An item row's overflow menu with Preview, Duplicate, Rules, and Delete

At the zone level you have two more dialogs:

  • Rules (rotation policy) — how the zone’s items cycle: Alternate playback, how many content units per cycle, the play order, and whether to resume from the same spot on an update.
  • Settings — a cross-device sync group so several screens play in step, with a master toggle.
Zone Rules — how the zone's items rotate and cycle
The zone Rules dialog: alternate playback, units per cycle, play order, and resume-on-switch
Zone Settings — a cross-device sync group and its master
The zone Settings dialog with a sync group name and a master toggle

If an item’s resolution does not match its zone (for example, a portrait image in a landscape zone), the editor can show a small mismatch hint next to the item, reminding you that the chosen Scale mode will letterbox or crop it. Use the fit modes in the item’s Rules to control how it fills the zone.

Step 2 controls when the campaign runs.

  • Unlimited — leave the run window open-ended, or turn it off and set From and To dates and times.
  • Sequential switching — play the campaign’s items in sequence.
  • Add rule — add periodicity rules for finer control: each rule card carries its own date bounds, weekday chips, month chips, and time windows, and can be copied or deleted.
  • Budget — an amount and currency.
Step 2 — the run window, periodicity rules, and the budget fields
Step 2 Set schedule expanded: Unlimited off, From and To set, one periodicity rule card, and the budget fields

Step 3 picks the screens the campaign plays on.

  • Parameters opens the device tree — pick the screens (and folders of screens) to target. A device-count chip shows how many are selected and also opens the picker.
  • Geotargeting — turn it on to also filter by location, drawing circular zones on a map. See Geotargeting for the full walkthrough; a screen without saved coordinates is excluded while geotargeting is on.
Choose places — pick the screens from the device tree
The device tree picker dialog with two screens, one checked
Geotargeting on — add circular zones to filter targets by location
Step 3 with Geotargeting turned on and a map showing one circular zone

Step 4 has the START button. Pressing it validates the campaign and publishes it. It lands Active (start date now or past) or Planned (future start date). See what START does.

Step 4 — press START to validate and publish
Step 4 Launch campaign expanded, showing the START button

This is the one thing to get right.

After SAVE, a running campaign shows the Draft pill — press START to publish again
The editor of a previously active campaign showing a Draft status pill right after SAVE

The editor has a Multi-template toggle at the top. Turning it on lets one campaign carry several template blocks, each with its own content and screens — useful when different screens should show different layouts under one campaign. See Multi-template campaigns.

If START fails, the editor shows a single general message (“Could not launch”) rather than a specific reason. Work through this checklist — it lists the reasons a launch is blocked and how to fix each. The code column is only for support requests.

Code (for support) What it means What to do
PLAYLIST_EMPTY A zone or template has no media Add at least one item to every zone
MEDIA_NOT_READY A file is still processing, not approved, or outside its active period Wait for processing, approve it in Content, or fix its active dates
MEDIA_INVALID A duplicate or broken media reference Remove and re-add the item
SCHEDULE_RANGE_INVALID The start/end is missing or the end is not after the start Fix the dates in step 2
SCHEDULE_POLICY_INVALID / TIMEZONE_INVALID A broken schedule policy or timezone (rare) Recreate the campaign, or contact support
TARGET_EMPTY No confirmed screen matches Pick screens in step 3, and confirm the screen first
TARGET_DEVICE_UNAVAILABLE A picked screen was deleted or is unconfirmed Reopen the device picker and re-pick
TARGET_INVALID / TARGET_QUERY_FAILED An internal targeting error Re-pick the screens and retry
GEO_ZONE_INVALID / TARGET_GEO_EMPTY A bad geo zone, or the zones exclude every screen Fix the zones; screens without coordinates are excluded — see Geotargeting
ENTITLEMENT_REQUIRED No targeted screen has an active subscription Start the trial or a plan — see Plans
TEMPLATES_EMPTY Multi-template mode with no template blocks Add a template block
DEFINITION_INVALID The campaign could not be read (rare) Recreate the campaign, or contact support
CAMPAIGN_ARCHIVED Archived campaigns cannot be published Restore the campaign first
CAMPAIGN_REVISION_CONFLICT Someone else changed the campaign Reload the campaign and redo your edit