Reference · Advanced · 2 min read
The ChordPro Format — an Open Standard for Chord Sheets
Every song on EasyChording is a plain-text ChordPro file. Learn the syntax so you can write, edit and contribute songs.
ChordPro is an open, plain-text format for songs with chords. It has been around since the early 1990s and is supported by many songbook apps. Because it is plain text, a ChordPro file is easy to read, easy to edit, works with version control, and will never be locked inside one website — including this one.
Chords in brackets
Put each chord in square brackets immediately before the syllable where it changes:
[G]Amazing [G7]grace, how [C]sweet the [G]sound
The brackets are removed when the song is displayed and the chords are drawn above the lyrics.
Directives
Lines in curly braces are directives. The most common ones:
| Directive | Short form | Purpose |
|---|---|---|
{title: …} | {t: …} | Song title (required) |
{artist: …} | Performer or writer (required) | |
{key: G} | Original key — drives transposition | |
{tempo: 80} | Beats per minute | |
{time: 3/4} | Time signature | |
{comment: …} | {c: …} | A performance note |
{start_of_chorus} | {soc} | Begin a chorus |
{end_of_chorus} | {eoc} | End a chorus |
{chorus} | Repeat the last chorus |
Verses and bridges work the same way with {start_of_verse} / {start_of_bridge}, and you can add a label: {start_of_verse: Verse 2}.
Extra metadata
EasyChording reads a few extra fields through the standard {meta: name value} directive:
{meta: genre Hymn}
{meta: difficulty beginner}
{meta: description A short summary used for search engines.}
{meta: featured true}
A complete example
{title: Down in the Valley}
{artist: Traditional}
{key: G}
{time: 3/4}
{meta: genre Folk}
{start_of_verse}
[G]Down in the valley, the valley so [D7]low
Hang your head over, hear the wind [G]blow
{end_of_verse}
Write your own
The song editor gives you a live preview as you type, can convert plain chords-over-lyrics text to ChordPro automatically, and lets you download a .cho file or submit it to the library. Any song page also offers its source as a .cho download.