Skip to content

Getting started

This guide walks you through your first hour in the SoundSpots admin.

1. Sign in

Open the admin URL provided by your administrator and sign in with the account you were invited with. Accounts are created by invitation only — you cannot self-register.

2. Pick an organization

Each user belongs to one or more organizations. If you only have one, you go straight to the place list. If you have several, the place list has an organization filter at the top — pick the one you want to work in.

Note

Organization-level data — like the iBeacon UUID library — is shared across every place in that organization. Switching organizations changes which library you're saving to.

3. Open or create a place

The place list shows every place in your organization(s). Each row shows:

  • Place name
  • Organization
  • iOS compatible — see Places for what this means
  • Audio storage usage
  • A QR code for the public app deep-link

Administrators see additional columns for archiving, inviting collaborators, and downloading content.

To create a new place: click Create place, choose the organization (if you belong to several), and give it a name. You'll land directly in the editor for the new draft.

4. The editor at a glance

The editor is split into a few main areas:

  • Map — visual representation of spots and zones in the place. Click a spot to select it; the right side shows its details.
  • Spot list / cue list — the list of sound spots, in order. Drag to reorder.
  • Ambient zones — zones that play continuous background sound while a listener is inside them.
  • Settings — place-level metadata: name, description, languages, BLE scanning mode, default volume, and more.
  • Versions — the draft and published history. See Publishing.

5. Build your first spot

  1. Click somewhere on the map to drop a marker spot, or use Add spot to add one without positioning it.
  2. Open the spot's Sound files section and either drag in a file or pick one from the sound file library.
  3. Open Triggers and decide how the spot should fire. For most setups: an iBeacon trigger.
  4. Save is automatic — every edit is sent to the server immediately. You'll see a "saved" badge briefly when changes finish syncing.

6. Publish

When you're happy with the draft, open the version selector and click Publish. The mobile app picks up the new version on its next sync. See Publishing for the full workflow including release notes and reverting.