SanctuaryDOCS
Open App
Setlist Detail

Setlist Editor

Serve
Access:Super AdminTeam LeaderWorship Leader

The Setlist Editor is where you build and refine worship setlists song by song. It features a drag-and-drop song list, an intelligent suggestion engine that recommends songs based on key flow, freshness, genre variety, and seasonality, inline chord chart preview with transposition, a comments thread for team collaboration, and a full-screen Stage View for live performance.

Getting Here

Navigation: Serve → Setlists → Click a setlist (or + New Setlist)

Overview

The page is divided into three areas: a setlist panel on the left showing the ordered song list, a centre panel with the chord chart viewer for the selected song, and a right panel with the song library browser and suggestion engine. A comments thread can be toggled for team discussion. The page header shows the setlist title (inline-editable), status badge, linked service info, and action buttons.

Fields & Controls

Setlist Header

FieldTypeDescription
Title*Editable textClick the title to edit it inline. Changes are saved automatically.
StatusBadgeDRAFT or READY. Can be toggled via the status button.
Linked ServiceDisplayShows the linked service title and date. Can be changed or unlinked.
Stage ViewButtonOpens the full-screen dark-mode Stage View for live performance.

Song List (Left Panel)

FieldTypeDescription
Song ItemDraggable rowEach song shows title, artist, effective key, and position number. Drag to reorder.
Effective KeyBadgeThe key this song will be played in for this setlist (may differ from the song's default key).
Key OverridePickerChange the key for this specific setlist item without affecting the song's default.
Leader AssignmentDropdownAssign a worship team member to lead this particular song.
RemoveButtonRemove the song from the setlist.

Chord Chart Viewer (Centre Panel)

FieldTypeDescription
Chart DisplayRendered textChordPro-parsed chord chart with chords rendered above lyrics. Sections are labelled (Verse, Chorus, Bridge, etc.).
Key TransposeKey pickerTranspose the displayed chart to any key. The circle picker shows all 12 keys.
CapoCalculatedCapo fret number based on transposition distance. Updates automatically.
NotationToggleStandard chord names or Nashville Number System.

Song Library Browser (Right Panel)

FieldTypeDescription
Library SearchText inputSearch the full song library to find songs to add.
SuggestionsRanked listAI-powered song suggestions scored by freshness, key flow, genre variety, and seasonality.
Suggestion ScoreNumericEach suggestion shows its score and reasoning (e.g., "8w fresh", "Key: G", "Adds variety", "Seasonal").
Recency BadgeBadgeWarning if a song was used very recently (last week = red, 2 weeks = amber).
Usage CountNumericHow many times the song has been used, colour-coded by frequency.

Comments Thread

FieldTypeDescription
Comments ToggleButtonShow or hide the comments panel.
Comment InputTextareaType a message and send to the setlist discussion thread.
Comment ListThreadChronological list of comments from team members with timestamps and avatars.

Actions

Add a Song from the Library

  1. Browse or search in the right-panel song library
  2. Click a song to add it to the setlist
  3. The song is appended at the end of the list

Reorder Songs

  1. Drag a song item by its handle in the left panel
  2. Drop it at the desired position
  3. The order is saved automatically via the reorder API

Change a Song's Key

  1. Click the key badge on a song item
  2. Select the new key from the picker
  3. The chord chart in the centre panel updates to reflect the new key

Assign a Song Leader

  1. Click the leader assignment dropdown on a song item
  2. Select a worship team member from the candidates list
  3. The leader name appears on the song item

Mark Setlist as Ready

  1. Click the status button in the header
  2. The status toggles from DRAFT to READY (or vice versa)
  3. READY status signals to the team that the setlist is finalised

Open Stage View

  1. Click the Stage View button in the header
  2. A full-screen dark-themed view opens with large chord charts
  3. Navigate between songs using arrow keys or on-screen buttons
  4. Adjust font size (S, M, L, XL) for different screen distances

Related Pages

PreviousSetlists
NextAvailability