Skip to content

Publishing

The mobile app only ever serves published content. Editing happens on the draft — your changes are saved continuously, but they don't reach listeners until you publish.

Drafts and versions

Every place has:

  • One draft — the editor's working copy. Always present, always editable.
  • Zero or more published versions — frozen snapshots, each with a release note and timestamp. Once published a version is immutable.

The version selector at the top of the editor lets you switch between the draft and any published version. Published versions open in read-only mode — useful for reviewing what listeners are actually seeing right now.

Publishing the draft

  1. Open the version selector in the editor.
  2. Click Publish.
  3. Enter a release note. Keep it short and specific — "Added new spots in west wing", "Fixed audio levels on entry sound" — the field is shown in the version history forever.
  4. Confirm.

A new version is created from the current draft, the draft remains as-is for further edits, and the mobile app picks up the new version on its next configuration sync.

Tip

Publish often. Small, frequent versions with clear release notes are easier to roll back than large monthly drops.

Reverting

If a published version turns out to be broken:

  • Revert to latest published — drops the current draft and rebuilds it from the most recent published version. Use this when the draft has gone wrong but the published version is fine.
  • Revert to a specific published version — same as above but you pick which version to copy from. Use this when both the draft and the latest version are broken and you need to go back further.

Reverting only changes the draft. The published versions are not modified — to actually change what listeners see, you publish again from the reverted draft.

Activating a version

Multiple published versions can exist simultaneously. The mobile app serves the active version. Activate a version by opening it in the version selector and clicking Activate — useful for promoting a tested version, or rolling back to a known-good one without losing newer versions.

Version diffs

The version selector has a Compare option that shows what changed between two versions: spots added/removed, settings changed, sound files swapped. Useful for sanity-checking a draft before publishing, or for understanding what changed between two old versions when troubleshooting a regression report.