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.