Spots¶
A spot is a discrete sound event tied to a place. When a listener's phone determines they've entered the spot – based on the spot's triggers – the spot's sound files start playing.
Spot types¶
- Marker spot – a single point on the map. Used with beacon, WiFi, or GPS-circle triggers to mark a specific location.
- Polygon spot – a shape on the map. Used with GPS-area triggers when entering anywhere inside a region should fire the spot.
You don't pick the type up-front; the admin promotes a marker to a polygon automatically when you add a GPS area trigger to it, and demotes it back when you remove the polygon.
Anatomy of a spot¶
Each spot has:
- Name – visible to admins and (optionally) to end users.
- Description / summary / cover image – surfaced in the app when the listener taps the spot.
- Sound files – the audio that plays.
- Triggers – one or more of Beacon, iBeacon, WiFi, GPS. A spot fires when any of its triggers fires.
-
Rules – optional gating that runs after a trigger fires, to control whether the spot actually plays. See Rules.
-
Priority – when multiple spots want to play at once, higher priority wins.
- Play mode, loop, run-once, play-full-after – control playback behaviour.
- External identifier – a stable id you control. Useful when integrating with other systems.
Selection and editing¶
Click a spot on the map or in the spot list to select it. The right-hand panel shows its details, organised into sections:
- General
- Description
- Sound files
- Triggers
- Rules
- Advanced
Edits are saved continuously – no save button. A small badge shows when changes are still syncing.
Reordering and grouping¶
Drag spots in the spot list to reorder them. Order matters when:
- You're using the cue list to chain spots in sequence.
- You're using "play full after" rules that depend on previous spots.
Spots can also be grouped into ambients – a separate organisational unit that determines how spots interact with ambient zones. Drag a spot onto an ambient header to assign it.
Deleting a spot¶
Click the trash icon on a selected spot. If the spot is referenced by another spot's or zone's rules, the admin warns you and lists the dependents – deleting will leave dangling references that you'll see flagged in the rules panel.
On-demand mode¶
If the place is in on-demand mode (set in place settings), spots don't fire automatically from triggers. Instead, the listener taps a spot in the app to play it. Triggers are ignored for that place. Use this for guided tours where the listener controls the pace.