How to write songs in ChordPro: chords, directives, an example
7 min read
ChordPro is the most common way to write songs with chords as plain text. Chords and lyrics sit on the same line, so the chords never slide onto the wrong syllable when the font or screen width changes. This article covers writing a song in ChordPro from scratch: where the chords go, the directives that carry the song's details, a complete example and the most common mistakes. What the format is and how to convert other formats is covered by the [ChordPro tool](/en/tools/chordpro/).
Hit a term you don’t know? Music terms glossary
Chords: square brackets, before the syllable
The whole rule is this: write the chord in square brackets immediately before the syllable it is played on. The viewing app draws the chord above that syllable. What matters is not where on the line it sits but which letter it sits in front of.
| You type | What happens |
|---|---|
| [C]Woke up early this morning | C above “Woke” |
| Looking[F] at the empty spaces | F above “at” (a chord can also fall at the end of a word) |
| shin[G]ing on this lonely town | G in the middle of a word: “shin-ing” |
| [C][Am][F][G][C] | A chords-only line: intro, interlude or ending |
| [D/F#] | Slash chord: D with F♯ in the bass |
Write # or ♯ for sharp and b for flat: [F#m], [Bb]. Use B in international naming; not every program recognises the German H.
Directives: the song's details
Lines in curly braces are called directives. They do not show as lyrics; they describe the song's title, key, tempo and sections. They usually go at the top of the file.
| Directive | Meaning |
|---|---|
| {title: Echoes in the Rain} | The song title ({t: …} also works) |
| {subtitle: Songlivo} or {artist: …} | Artist or subtitle |
| {key: C} | The song's key |
| {tempo: 84} | Tempo in beats per minute (BPM) |
| {comment: Verse 1} or {c: Verse 1} | Section label or note; shows as a heading |
| {start_of_chorus} … {end_of_chorus} | Chorus block ({soc} … {eoc}) |
| {start_of_tab} … {end_of_tab} | Tab or plain-line block, not laid out over lyrics ({sot} … {eot}) |
A complete example
Type the lines below into a text file in order and save it with a .cho extension, and any ChordPro reader will open it. The song is Songlivo's own sample song, so you are free to copy it.
- {title: Echoes in the Rain}
- {subtitle: Songlivo}
- {key: C}
- {tempo: 84}
- {comment: Verse 1}
- [C]Woke up early this morning, [Am]with a heavy heart inside
- Looking[F] at the empty spaces, where [G]the old memories hide
- {start_of_chorus}
- [Dm]Walking down the rusty [Am]streets, where[G] the autumn leaves fall[C] down
- {end_of_chorus}
- {comment: Outro}
- [C][Am][F][G][C]
Common mistakes
- Lining chords up with spaces on the line above the lyrics. That is the “chords over lyrics” layout, not ChordPro; when the font changes the chords drift. Put the chord inside the line in square brackets.
- Using round brackets: (G) is not read as a chord, it is taken for lyrics. A chord is always in square brackets.
- Spaces inside the brackets: write [G], not [ G ].
- An unclosed bracket: a chord that opens with [Am and never closes makes the rest of the line look like a chord.
- Forgetting the colon in a directive: write {title: Echoes}, not {title Echoes}.
ChordPro in Songlivo
Songlivo stores songs as ChordPro; in the editor you type chords in square brackets. When you import a .cho or .pro file from elsewhere, this is what happens:
- {title}, {subtitle} or {artist}, and {key} are read and written into the song's title, artist and key fields.
- {c: …} and {comment: …} are kept as section labels and show as headings in the song. That is why writing the chorus heading as {c: Chorus} is the safest way.
- Other directives, such as {tempo}, {capo} and the {soc} / {eoc} markers of a chorus block, are skipped; the lyrics and chords inside stay in the song.
- A file with chords written on the line above the lyrics is read too: Songlivo converts it to inline ChordPro by itself.
You save the tempo to the song from the metronome; the capo is each player's own setting and is not written into the song. That way a bassist playing without a capo and a guitarist with a capo at the 3rd fret each see their own chords.
To convert a chords-over-lyrics text to ChordPro or check what you have written, use the ChordPro tool. The steps for bringing songs over from another app are in moving your songbook.
THE TOOL FOR THISWhat is ChordPro, and how do you convert it?