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.
The editor header
Section titled “The editor header”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 four steps are Create content, Set schedule, Choose places, and Launch campaign. Work through them in order.
Step 1 — Create content
Section titled “Step 1 — Create content”This is where the campaign’s look and its media come together.
Pick a template
Section titled “Pick a template”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.
Choose a scene
Section titled “Choose a scene”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.
Work with zones
Section titled “Work with zones”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.
Add content
Section titled “Add content”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.
Set per-item rules
Section titled “Set per-item rules”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.
Per-item actions
Section titled “Per-item actions”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.
Zone Rules and Zone Settings
Section titled “Zone Rules and Zone Settings”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.
Resolution hints
Section titled “Resolution hints”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 — Set schedule
Section titled “Step 2 — Set schedule”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 3 — Choose places
Section titled “Step 3 — Choose places”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.
Step 4 — Launch campaign
Section titled “Step 4 — Launch campaign”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.
SAVE vs START
Section titled “SAVE vs START”This is the one thing to get right.
Multi-template campaigns
Section titled “Multi-template campaigns”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.
Why START can fail
Section titled “Why START can fail”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 |
See also
Section titled “See also”- Campaigns — the list, card menu, and detail page
- Campaign statuses and lifecycle — SAVE vs START, and the six statuses
- Content and Playlists — the media you add
- Geotargeting — filter targets by location
- Multi-template campaigns — several layouts in one campaign
- Plans, trial and billing — the subscription a publish needs