Import / Export

Export your room's timers, messages and questions as a file — as a backup or for use in other tools. Pro and Enterprise rooms can also import files.

Plans: JSON export is available on every plan. CSV/ZIP export and all imports require Pro or Enterprise — on Free, the Import menu item and the CSV option are shown with a crown icon.

Exporting

In the Controller, open the room menu (your avatar, top right) and choose Export.

  1. Choose JSON or CSV.
  2. Tick what to include: Timers, Messages and Questions (each shows its count; empty types cannot be ticked).
  3. Click Export. The file downloads straight away.

JSON

One versioned file (stagetick-YYYY-MM-DD.json) with everything you ticked, including all timer fields. JSON exports and the automatic backup keep every timer setting, including flash and sound cues. Use JSON for backups and for moving a show to another room.

CSV (Pro and Enterprise)

With one type ticked you get a single CSV file, for example stagetick-timers-YYYY-MM-DD.csv. With several types ticked, StageTick downloads one ZIP archive (stagetick-YYYY-MM-DD.zip) containing timers.csv, messages.csv and/or questions.csv. CSV files are comma-separated and open in any spreadsheet application.

CSV files start with a UTF-8 byte order mark so Excel shows umlauts and other special characters correctly. A character that a spreadsheet could read as the start of a formula gets a tab in front of it, at the start of a cell and after a semicolon; the import removes these tabs again.

Importing (Pro and Enterprise)

Importing replaces the existing items of each selected type in this room — it does not add to them:

  1. In the Controller, open the room menu (your avatar) and choose Import. A file picker opens for a JSON, CSV or ZIP file.
  2. StageTick shows what it found in the file, for example “6 timers” and “3 messages”. Untick any type you do not want to import.
  3. If the room already has items of a selected type, the dialog warns: “This will replace your existing data. A backup will be downloaded automatically.” Click Import to continue or Cancel to stop.
  4. Before replacing anything, StageTick downloads a backup of the items it replaces (stagetick-backup-….json) and then shows an Undo button for 30 seconds.

Imported items get new IDs, so you can import the same file into several rooms.

You can import these files:

  • JSON files — a full bundle as exported by StageTick (version: 2; files with version: 1 still import) or a plain array of timers. A file from a newer StageTick version is refused with a message asking you to reload StageTick.
  • CSV files — recognised by their header row as a timer, message or question CSV. The CSV import reads Windows line endings, line breaks inside a cell, a UTF-8 byte order mark, semicolon-separated files (as Excel with a German locale saves them) and yes/no cells written as TRUE/FALSE, WAHR/FALSCH or 1/0.
  • ZIP archives — must contain files named timers.csv, messages.csv and/or questions.csv

Room settings such as the title, time format and output password are not part of an export.

CSV column reference

The first ten timer columns must be present. Durations are written as times (for example 05:00).

Timer CSV

title, speaker, duration, wrapUpTime, dangerTime, trigger, appearance, labelColor, notes, targetTime, flashOnPhase, soundOnPhase, soundPreset

targetTime is a time of day, HH:MM or HH:MM:SS (for example 14:30). Leave it empty for timers without one. flashOnPhase and soundOnPhase are true, false or empty (default), soundPreset is one of beep, chime, bell, pulse, escalate or empty (default). The last three columns are optional; older files without them still import.

Message CSV

text, color, bold, uppercase, visible

Question CSV

text, author, submittedAt, live

Import validation

When importing, StageTick validates your file before processing:

  • File size limit: 1 MB maximum
  • Item count limit: 500 items per type (timers, messages, questions)
  • Type checking: column headers and data types are validated against expected schemas

If validation fails, an Import failed message explains what went wrong. Nothing is written to your room.

Backup and undo

Before an import replaces existing timers, messages or questions, StageTick downloads them as a JSON backup file. After the import, a banner offers Undo for 30 seconds: it restores the replaced lists exactly, so items imported into an empty list are removed again. Undo only applies to the room you imported into; switching rooms or reloading the page ends it, and the downloaded backup file stays.

Tip: Export your show as JSON before the event to keep a copy of your timers, messages and questions.