Skip to content

Writing songs

This page is for Songwriters and Admins. Adding, editing and deleting songs all happen in the admin panel.

Choose Admin from the menu with your name at the top right. The menu only offers it to Songwriters and Admins; a Singer who opens the admin panel’s address sees Page not found.

The sidebar on the left has:

  • Dashboard, and Users for Admins.
  • Content: Songs, Categories, Corrections and Media, and Logs for Admins. A number beside Corrections counts the corrections waiting for review.
  • Site (Admins only): Themes, Settings, Email templates and Audit. See Administration.

At the bottom of the sidebar are your name and role, Return to site (which takes you back to the songbook), Log out, and the light and dark button. On a narrow screen, the sidebar folds away behind the ☰ button.

The dashboard starts with To do: how many corrections are waiting, with a link to them, or Nothing waiting. Below that it counts the site’s Songs and Categories; select a count to go to that section. Under Recent activity are the 10 latest things anyone has done on the site, such as a song being edited or a correction accepted.

Admins see more on the dashboard; see The dashboard.

Songs lists every song, 25 to a page, with its Title, Artist, Categories and when it was last Updated.

  • Type in Search title or artist… and press Enter to find a song.
  • Select a column heading to sort by it. Updated puts the most recently changed songs first.
  • Select a title or Edit to open a song in the editor, or View to open it on the site in a new tab.

Select New song, fill in the form, and select Create song. You go back to the song list, which says Song created. If the Title or Lyrics & chords is empty, nothing is saved: the form stays as you left it, with A title is required. or The lyrics and chords are required. beside the field.

The form has these fields:

  • Title (required).
  • Artist. Leave it as Unknown if you don’t know.
  • Subtitle and Album, both optional. They’re shown beside the artist at the top of the song.
  • Key, such as C, Am or G. It’s shown at the top of the song, and when someone transposes the song, Songbook shows them the new key worked out from this one. Leave it blank if you’re not sure.
  • Capo: the fret for the capo, from 0 (no capo) to 12. Anything above 0 is shown at the top of the song.
  • Categories: tick every category the song belongs in. See Categories. If there aren’t any yet, the form says so.
  • Custom chord definitions: shapes for chords Songbook doesn’t know, or that you want played differently in this song. See Custom chords.
  • Song notes (Markdown), optional. Shown on the song page between the toolbar and the song. See Song notes.
  • Lyrics & chords (ChordPro), required: the song itself. See The ChordPro format.

To check how the song will look before you save it, use Preview.

Each song’s address comes from its title: a song called “Down by the Harbour” is at /songs/down-by-the-harbour. If two songs have the same title, the second gets -2 on the end, and so on.

Open a song from the song list, change what you need, and select Save song. You go back to the song list, which says Song saved. Select Cancel to leave without saving.

In the editor, select Delete… at the top, beside View ↗, then Delete song to confirm. The song is removed for good, and so is everything that depends on it: it comes off everyone’s favourites and setlists, and its corrections are deleted.

Two buttons above Lyrics & chords save typing the most common markings:

  • Chorus, with nothing selected, adds an empty chorus and puts the cursor inside it, ready for the words. With lines selected, it wraps them in a chorus. Either way the chorus gets a CHORUS label above it:

    {comment: CHORUS}
    {start_of_chorus}
    Sing it [F]loud, sing it [G7]out to the [C]sea
    {end_of_chorus}
  • Verse adds a {comment: Verse} label on its own line where the cursor is, or directly above the lines you’ve selected.

Everything else you type yourself. The ChordPro format explains it all.

Select Preview, beside the Lyrics & chords heading, to see the song sheet as it stands, without saving. It opens over the editor, headed with the title and artist you’ve typed, and shows the song and its chord diagrams just as the song page lays them out, including any custom chords.

The preview uses your own display options, such as font size, chord placement, tuning and where the diagrams go, and it’s never transposed. The song notes and the tags at the top of the song aren’t part of it.

If Lyrics & chords is empty, the preview says Nothing to preview yet — type some lyrics and chords first.

Close it with ×, by pressing Escape, or by selecting outside it, and carry on editing. Nothing is saved until you select Save song or Create song.

Song notes are for anything that helps someone play the song: the strumming pattern, where the song comes from, a recording to play along with. They’re written in Markdown, and a toolbar above the box adds the formatting for you. Most buttons work on the text you’ve selected, or insert a placeholder word if nothing is selected.

Button What it does
B, I, S Bold, italic and strikethrough.
“” Turns the selected lines into a quote.
Text style menu Paragraph, Heading 2, Heading 3 or Heading 4 for the selected lines.
• List, 1. List Turns the selected lines into a bulleted or numbered list.
Code Marks the selection as code: inline for part of a line, or a code block for several lines.
Link Asks for the Link text and URL, and adds the link.
Media Adds a picture, video or audio file from the media library. See below.
Embed Asks you to paste embed code, such as a YouTube <iframe>, and adds it as you paste it.

Select Media to open the Media library. Choose a folder or type in Search files… to find a file, or select Upload to add a new one from your computer. Then select the file you want:

  • A picture: Songbook asks for its Alt text, a short description for anyone who can’t see it. Please always fill it in.
  • A video: the media library opens again for you to choose a cover picture, shown before the video plays. Pick or upload one.
  • An audio file: a player is added.
  • Anything else, such as a PDF: a link to it is added.

The song notes box shows Markdown and HTML, not the finished result. Save and view the song to see how the notes look.

To keep the song page safe, Songbook only shows what the toolbar can make. Pictures, video and audio have to come from the media library, and the only embedded players shown are YouTube videos. Anything else, such as embed code from another site or a picture linked from elsewhere, is left out of the song page. For more on the library itself, see The media library.