Skip to Content

ChordPro Command Reference

ChordPro is a simple way to write lyrics and chords together. Put a chord in square brackets immediately before the word or syllable where it should be played. Use commands in curly braces for song information and supported chart annotations.

Using the Restorative Worship Song Chart Builder: You can enter the title, original key, and tempo in the Song details fields, or paste {title: ...}, {key: ...}, and {tempo: ...} into the notation to populate those fields. You can then edit the fields as needed. Set the time signature directly in the builder for now. This reference documents notation tested with the builder, rather than every directive in the wider ChordPro specification.

Basic notation

Write [C]Here we [G]go to place C over “Here” and G over “go.” A chord can also be inserted within a word, such as Ama[G]zing. Use {comment: Verse 1} to start a section. Blank lines help keep your source readable; the player does not treat them as extra chart spacing.

Notation supported by the Song Chart Builder

NotationWhat it doesExample
Chord bracketsPlaces a chord before the word or syllable where it changes. Use one chord per set of brackets.[C]Sing with [G]joy
Chords within wordsPositions a chord change within a word.Ama[G]zing
Section headingStarts a named section such as Intro, Verse, Chorus, Refrain, Bridge, Tag, or Outro. This is the builder's established use of the comment directive.{comment: Verse 1}
Short headingEquivalent shorthand for a section heading in this builder.{c: Chorus}
Song titlePopulates the builder's song title field when the notation is imported.{title: Example Song}
Original keyPopulates the builder's original key field when the notation is imported.{key: G}
TempoPopulates the builder's tempo field when the notation is imported.{tempo: 84}
Instrumental chordsDisplays a line of chords without lyrics. Put each chord in its own brackets.[Em7] [Csus2] [G] [Dsus4]
Trailing chordsContinues a progression after the last lyric word. Separate bracketed chords with spaces.[Em7]Him. [Csus2] [Em7] [Csus2]
Performance noteShows a plain-text direction when written in parentheses on its own line.(Repeat twice)

The title, key, and tempo directives above were tested for field population. Other metadata and start/end section directives are not documented here pending verification. The player also offers transposition, Nashville numbers, and lyrics-only views; those are player controls, not ChordPro commands.

Example: notation and result

This example shows how song information and chord notation become a chart. The title, key, and tempo can populate the builder's Song details fields from the notation; set the time signature to 4/4 in the builder. Exact chord spacing depends on the player and screen width.

ChordPro input

{title: Example Song}
{key: G}
{tempo: 84}
{comment: Chorus}
[G]We lift our [C]voices in [G]praise
[Em]We sing of Your [D]faithfulness
[G]Through every [C]season and [Em]day
[D]Our hope is found in [G]You

Illustrative chart preview

Example Song

Key G · Tempo 84 · Time 4/4
Chorus
G     C    G
We lift our voices in praise
Em     D
We sing of Your faithfulness
G     C   Em
Through every season and day
D        G
Our hope is found in You

Practical tips

  • Place each chord immediately before the lyric syllable where the chord change occurs.
  • Use {comment: Verse 1}, {comment: Chorus}, {comment: Bridge}, and similar headings to organize your song.
  • Keep chord spellings consistent, especially for suspended chords and slash chords.
  • Use the builder's live preview to check how your song will actually appear.
  • Use a separate bracket for each chord, including instrumental passages and chords after the final lyric.
  • You can paste {title: ...}, {key: ...}, and {tempo: ...} to populate the corresponding fields, or enter those values directly in Song details.
  • For now, use the builder's Song details field to set the time signature.