SanctuaryDOCS
Open App
Songs

Song Library

Serve
Access:Super AdminLead PastorPastorTeam LeaderWorship LeaderReporting Only

The Song Library is a full-featured worship song catalog. It stores songs with metadata (key, tempo, genre, CCLI number), supports multiple arrangements with chord charts in ChordPro format, provides real-time key transposition, capo calculation, and tracks how frequently each song has been used. The page uses a master-detail layout: a searchable song list on the left, and the selected song's detail and chord chart on the right.

Getting Here

Navigation: Serve → Songs

Overview

The left panel displays all songs in a scrollable list with search and genre filtering. Clicking a song opens its detail in the right panel, showing metadata, usage KPIs, chord charts with transposition controls, arrangement tabs, and team notes. On mobile, the layout collapses to a single panel with a slide-out sidebar for the song list.

Fields & Controls

Song List (Left Panel)

FieldTypeDescription
SearchText inputSearch songs by title, artist, or CCLI number. Results filter as you type.
Genre FilterChip barFilter by genre: All, Worship, Praise, Hymn, Christmas. More genres may appear from your catalog.
Song RowList itemShows song title, artist/author, default key badge, tempo, and usage count. A recency badge appears if the song was used in the last 2 weeks.

Song Detail (Right Panel)

FieldTypeDescription
TitleDisplaySong title in large heading format.
Artist / AuthorDisplayThe credited artist or original author of the song.
Default KeyBadgeThe original key of the song (e.g., C, G, Bb).
BPMNumericTempo in beats per minute. Can be updated via tap tempo.
Time SignatureDisplayTime signature (e.g., 4/4, 6/8).
GenreBadgeMusical genre classification.
TagsBadge listSearchable tags and themes (e.g., "Grace", "Advent", "Communion").
CCLI NumberTextCCLI song number for licensing compliance.
YearNumericYear the song was published or released.
YouTube URLLinkLink to a reference recording or tutorial video.
ThemesBadge listTheological or topical themes associated with the song.

Usage KPIs

FieldTypeDescription
Total UsesNumericAll-time usage count across all setlists and services.
Uses This YearNumericNumber of times used in the current calendar year.
Uses This MonthNumericNumber of times used in the current month.
Recent UsageTableList of recent uses showing setlist title, service date, and key used.
Usage Frequency LabelBadgeColour-coded badge: "Not used yet" (gray), usage count with "in 90 days" (green/amber), or "used frequently" (orange for 8+ uses).
Recency BadgeBadge"Last week" (red) or "2 weeks ago" (amber) if the song was used very recently. No badge for songs 14+ days since last use.

Chord Chart Viewer

FieldTypeDescription
Arrangement SelectorTabsSwitch between arrangements (e.g., "Standard", "Acoustic"). The default arrangement is shown first.
Display KeyKey pickerTranspose the chord chart to any of the 12 keys. Uses a circular key picker (circle of fifths style).
CapoNumericCalculated capo position based on the transposition. Automatically computed when you change the display key.
NotationToggleSwitch between Standard notation (C, D, E) and Nashville Number notation (1, 2, 3).
View ModeToggleSwitch between Chord Sheet (chords above lyrics) and Lyrics Only (no chords) views.
Show ChordsToggleShow or hide chord symbols in the display.
Large TextToggleIncrease font size for projection or stage monitor use.
Team NotesTextareaFreeform notes field for the worship team (e.g., "Play softly on verse 2", "Key change at bridge").

Tap Tempo

FieldTypeDescription
Tap Tempo ButtonButtonTap repeatedly to calculate BPM from your rhythm. The detected BPM updates after 3+ taps.

Actions

Add a New Song

  1. Click the + Add Song button
  2. The song editor opens where you enter title, artist, key, tempo, genre, CCLI number, and lyrics
  3. Save to add the song to the library

Edit a Song

  1. Select a song from the list
  2. Click the Edit button in the detail panel
  3. Modify the song metadata and save

Transpose a Chord Chart

  1. Select a song with a chord chart
  2. Use the Key Picker circle to select the target key
  3. The chart transposes instantly — all chords update in real time
  4. The capo position is calculated automatically based on the transposition distance

Add Song to a Setlist

  1. Select a song from the list
  2. Click Add to Setlist
  3. Choose the target setlist from the modal
  4. The song is appended to the setlist

Archive a Song

  1. Only Super Admin users can archive songs
  2. Select the song and click Archive
  3. Archived songs are hidden from the default list view but not deleted

Related Pages

PreviousSchedule
NextSetlists