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.
{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
| Notation | What it does | Example |
|---|---|---|
| Chord brackets | Places a chord before the word or syllable where it changes. Use one chord per set of brackets. | [C]Sing with [G]joy |
| Chords within words | Positions a chord change within a word. | Ama[G]zing |
| Section heading | Starts 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 heading | Equivalent shorthand for a section heading in this builder. | {c: Chorus} |
| Song title | Populates the builder's song title field when the notation is imported. | {title: Example Song} |
| Original key | Populates the builder's original key field when the notation is imported. | {key: G} |
| Tempo | Populates the builder's tempo field when the notation is imported. | {tempo: 84} |
| Instrumental chords | Displays a line of chords without lyrics. Put each chord in its own brackets. | [Em7] [Csus2] [G] [Dsus4] |
| Trailing chords | Continues a progression after the last lyric word. Separate bracketed chords with spaces. | [Em7]Him. [Csus2] [Em7] [Csus2] |
| Performance note | Shows 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]YouIllustrative chart preview
Example Song
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.
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.
{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
| Notation | What it does | Example |
|---|---|---|
| Chord brackets | Places a chord before the word or syllable where it changes. Use one chord per set of brackets. | [C]Sing with [G]joy |
| Chords within words | Positions a chord change within a word. | Ama[G]zing |
| Section heading | Starts 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 heading | Equivalent shorthand for a section heading in this builder. | {c: Chorus} |
| Song title | Populates the builder's song title field when the notation is imported. | {title: Example Song} |
| Original key | Populates the builder's original key field when the notation is imported. | {key: G} |
| Tempo | Populates the builder's tempo field when the notation is imported. | {tempo: 84} |
| Instrumental chords | Displays a line of chords without lyrics. Put each chord in its own brackets. | [Em7] [Csus2] [G] [Dsus4] |
| Trailing chords | Continues a progression after the last lyric word. Separate bracketed chords with spaces. | [Em7]Him. [Csus2] [Em7] [Csus2] |
| Performance note | Shows 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]YouIllustrative chart preview
Example Song
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.