My songs

Quick start

1. Open My Songs from the sidebar (/my-songs).
2. Click Add song → /my-songs/new (editor help → Add or edit a song).
3. After saving, return to the list and use Compose, View, Edit, or Delete on a row.
4. Compose opens /my-songs/{id}/compose for the worship presentation wizard.

You should know how to browse church songs and open compose. For ChordPro authoring detail, see Add or edit a song. For the global catalog, see Songs library.

Deep dive

Page header

My Songs lists every song your church owns. The header includes:

• Contextual ? next to the title — short summary and link to this article
• On the list toolbar: Search and Add song

Song list

Control / action	Purpose
Search	Placeholder Search your songs (?keywords=); page size 50
Add song	Create at /my-songs/new → Add or edit a song
Title / View	Open the detail panel (SongDetailPanel with church source)
Compose	Open /my-songs/{id}/compose (church source)
Edit	Open /my-songs/{id}/edit → Add or edit a song
Delete	Confirm, then remove the song

Rows show writers when present, Key: {key} when available, and a Chords badge when hasChords is true.

Pagination

• Page size is 50 songs.
• When there is more than one page, a summary shows {start}–{end} of {total} songs with Previous / Next.

Empty state: No songs yet / Add your first song with chords or plain lyrics, with an Add song CTA.

Delete

Delete asks for browser confirmation:

Delete "{title}"?

Confirming sends DELETE /api/my-songs/{id}. Deletion is permanent for church songs.

Add and edit songs

Add song and Edit use the shared song editor on /my-songs/new and /my-songs/{id}/edit. That workflow — ChordPro text, preview, validation, save APIs, and the full format reference — is documented in Add or edit a song.

The inline Format guide on the editor page links to the same article for detailed ChordPro syntax and parse errors.

Compose from My Songs

Compose opens /my-songs/{id}/compose with bootstrap source=church. Wizard steps, worship outputs, and screen layout → Compose a worship presentation.

Songs with chord markers set hasChords, which enables Show chords on confidence monitor in compose when confidence is on.

After compose, further deck editing → Worship songs.

Global catalog

Read-only licensed and shared songs live in the Songs library. Use My Songs for originals and church-specific arrangements.

Tips

• Use Search when your library grows — titles and metadata are indexed.
• Save songs from the editor before Compose so the wizard reads the latest revision.
• Use View on a row for a quick read-only check without opening the editor.

Troubleshooting

No songs yet but I saved one

• Confirm save completed (toast Song saved.) and you were redirected to /my-songs. Refresh if needed.

Delete failed

• Confirm you have permission to manage church content. Retry after refreshing the list.

Could not load songs

• Refresh the page. Confirm you are signed in to a church account.

ChordPro or save errors

• See Add or edit a song — parse errors and validation are documented there.