Templates

Templates let you snapshot the full structure of an event or a show and replay it in future productions — without rebuilding from scratch each time.

What templates store

Event templates capture the entire event structure from a source event in a room:

• All shows (name, position, and every cue in each show)
• Every cue's title, type, timer mode, duration, end action, BPM, key, and time signature
• Team notes per cue (per team)
• Fixture assignments per cue (by fixture name, so they re-link on load)
• The room's fixture list and colour presets at save time
• Which teams were active in the room at save time

Show templates capture a single show:

• The show name and all its cues, with the same full cue detail as above

Note: Fixture settings are stored by fixture name and will re-link on load if a fixture with the same name exists in the target room. If names differ, fixture assignments are skipped for that fixture.

Where templates live

Templates are location-scoped — once saved, a template is available to every room in your location, not just the room it came from. This means you can build a template in your main stage room and apply it in a rehearsal room, or share structures across venues.

Creating templates

Templates are saved from the Templates tab in Room Settings (/dashboard/locations/[id]/rooms/[roomId]?tab=templates).

To save a template:

1. Click Event template or Show template to choose the kind.
2. Select the source event or show from the dropdown. Only events and shows that exist in the current room appear.
3. Enter a name for the template.
4. Click Save template.

The template snapshot is taken at save time. Editing the source event or show afterward does not update the template — save a new template if you want to capture the updated structure.

Deleting templates

Each template row in the list has a trash icon (hover to reveal). Click it and confirm to permanently delete the template. Deletion cannot be undone.

Who can save and delete templates

Any user with Owner, Director, or Associate Director access on at least one room in the location can create and delete templates. This includes Associate Directors — AD access is equal to Director for template operations.

System templates (retired)

Previously, CueProX offered a set of system-provided templates (Church Service, Corporate Event, etc.) that appeared when creating a new event or room. These have been retired in favour of user-created templates, which let you save real production structures that match your actual workflow.

If you had a workflow built around system templates, re-create it by running one of your real events through the Templates tab — the snapshot will be more accurate than the old generic starters.

Loading templates

Loading an event template

Event templates can only be loaded into a room that has no events yet — this prevents accidental overwrites.

When a room has no events, the director view shows a Load template button instead of a plain "Create event" button. Click it, select a template from the list, and confirm. The room is populated with the full event structure: all shows, cues, fixtures, colour presets, and active-team settings from the template snapshot.

If the room already has any events, the load is blocked. Delete existing events first if you want to start from a template.

Loading a show template

Show templates are loaded via the + Add show button in the director view action bar. If any show templates exist for the location, clicking the button opens a picker rather than the blank show form. Select a template, optionally rename the show (defaults to the template name), and confirm. The show is appended at the end of the event with all its cues and team notes.

To create a blank show instead, click Or start fresh instead at the bottom of the picker.

Loading into rooms with existing setup

When loading an event template, the target room must have no events — but it may still have existing fixtures, colour presets, or custom team-active toggles set up from previous work. In that case, CueProX detects the conflict and shows a merge dialog before loading.

The merge dialog appears for each conflicting category. You choose per category:

Fixtures (shown when the room has 1 or more fixtures):

• Overwrite — Delete all existing fixtures and replace with the template's list.
• Merge — Keep existing fixtures; add template fixtures whose name doesn't already exist in the room (case-insensitive). Duplicate names keep the existing fixture.
• Skip — Don't touch fixtures at all. Cue fixture assignments from the template that reference fixtures not in the room will be silently dropped (logged as warnings).

Color Presets (shown when the room has 1 or more presets):

• Overwrite — Delete all existing presets and replace with the template's.
• Merge — Keep existing; add template presets not already present by name.
• Skip — Don't change presets.

Active Teams (shown when the room's current active-team pattern differs from the template's):

• Overwrite — Set teams active/inactive to match the template snapshot.
• Skip — Leave the current active-team setup unchanged.

The merge dialog defaults to Merge for fixtures and presets, and Overwrite for teams. If the room has no conflicting data, the dialog is skipped and the template loads immediately.

Show templates never trigger the merge dialog — they only add a show, cues, and team notes to an existing event, leaving fixtures, presets, and team toggles entirely unchanged.

Fixture and team re-linking

When loading an event template:

• Fixtures are resolved by fixture type icon key. If a fixture type is no longer available, the fixture is created without a type (still usable, no icon).
• Team notes per cue are resolved by team slug. If a team slug from the template does not exist in the target location, the note is skipped.
• Room team active flags are updated when the "Overwrite" strategy is chosen for teams.

Any skipped items are reported as warnings in the server response (visible in server logs; the load still succeeds).