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:

DirectiveShort formPurpose
{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.

Keep learning

Reference · Beginner · 4 min read

Public Domain Songs — What They Are and How We Check Them

What "public domain" means for songs, how long music copyright lasts in the US and life+70 countries, why arrangements and recordings differ, and how EasyChording checks every song.

Piano · Beginner · 2 min read

How to Read a Piano Chord Chart

Learn to read chord symbols above lyrics and turn them into music on the keyboard — the fastest way to start playing real songs.

Theory · Beginner · 2 min read

Piano Chord Basics — Build Any Chord from Scratch

Understand semitones, major and minor triads and seventh chords, and you can build every chord in every key without memorising charts.