ChordPro syntax reference
ReferenceEvery directive and shorthand Akordo understands when rendering a chart.
A non-hot-reloadable change occurred and we must rebuild.
Checking account access…
Write ChordPro charts, keep arrangements, and rehearse with built-in tools.
Songs are your charts and everything attached to them. They live in your library, so the same current version is available on every device and to everyone you share with.
Each song has:
Open Songs in the navigation to see your library. The scope switcher in the top bar filters between Everything, Personal, and each group you belong to. On iPhone and iPad, the Show filter in Songs does the same: All songs, Personal, or a group's name.
A song opens in View mode. Switch to Edit with the View / Edit toggle in the header.
View mode is for reading and rehearsing. The toolbar gives you:
On iPhone and iPad, a song opens straight to its chart. The chips at the top change the arrangement and the key and capo, and show the metronome or backing track. The chart's More menu holds Notes, Tuner, Saved keys, Nashville numbers, Edit chart, Add to setlist, Song details, and Export PDF.
Edit mode has two editors. Switch with the Guided / Source toggle.
On narrow screens an Editor / Preview tab pair switches between the editor and the rendered chart. On wide screens both show side by side. Changes save automatically.
The Actions menu offers Show notes, Show ChordPro help (a syntax cheat sheet beside the editor), Manage for tunings, History, Add to setlist, Export PDF, and Share.
ChordPro keeps chords attached to the syllables they belong to, so nothing drifts when the font or screen size changes.
{t:Amazing Grace}
{key:G}
VERSE 1
[G]Amazing [G7]grace how [C]sweet the [G]sound
That [G]saved a [Em]wretch like [Am]me [D7]
The basics:
[C], [Am], [F]: chords go in square brackets before the syllable where they changeVERSE 1, CHORUS, BRIDGE on their own line: section headers{key:G}: the song key{c:Play softly}: a comment that shows in the chartFor every directive and shorthand, see the ChordPro syntax reference.
An arrangement is one way of playing the song. A song starts with one arrangement, and you can add more.
The arrangement name sits in the song header after the title. Select it to open the switcher (on iPhone and iPad, tap the arrangement chip at the top of the chart). Each arrangement shows its key, time signature, and BPM. From the switcher you can rename the current arrangement or create a new one.
Setlists remember which arrangement to use for each song, so the whole band opens the same one.
Select the Key chip in View mode and pick the key you want to play in. The chart transposes immediately. When no key is set, the chip is labelled Transpose and offers semitone offsets instead.
Choose a fret from the Capo selector. The chart shows the shapes to play with the capo on, and the selector labels each option with the key those shapes are in, for example "Capo 2 (C)" for a song in D. The sounding key stays the selected performing key. Capo is saved for your account, separately for each arrangement and vocal tuning (including Main). It does not change anyone else's chart or the setlist's key. Even members with view-only access can save their own capo; without a saved preference, the fret is 0.
The ABC / # toggle switches chords to Nashville numbers relative to the key. Numbers need a key, so the toggle is disabled until the song has one. Capo is ignored in numbers mode. Set your default in Account settings. On iPhone and iPad, Nashville numbers is a switch in the chart's More menu, and its default is in Stage settings › Charts.
A vocal tuning is a named, shared transposition from the arrangement's original key. Your capo preference is separate. Pick Main to use the arrangement's own key, choose a saved tuning, or set Custom values and then Save preset to name them, for example "Sarah" or "Tenor". Manage opens the full list. On iPhone and iPad these are called Saved keys, in the chart's More menu.
For a song that modulates, put TRANSPOSE KEY +2 on its own line. Everything after it shifts up two semitones. Use a negative number to go down. Shifts accumulate, so a song can change key more than once.
Open Show notes from the Actions menu (on iPhone and iPad, Notes in the chart's More menu). Notes belong to the arrangement and come in two kinds:
Each note can be Public, visible to everyone with access to the song, or Private to you. Notes can carry tags for who they are aimed at, such as a vocalist or instrument. The Build Tab button opens a tablature builder that inserts formatted tab into a note.
An arrangement's Recordings are its uploaded audio tracks and its recording links, shown together in one row. Uploads and links belong to an arrangement; a setlist uses the recordings of its selected arrangement.
Recording changes take effect immediately: uploads start as soon as you confirm the rights attestation, and a link is saved the moment you add it, without any form's Done or Save.
Choose Upload audio file or Add link:
To upload:
The Recordings sheet lists every uploaded track and every link. On web each track shows its length, size, detected key, and detected tempo and time signature; on iPhone and iPad a track shows its name, length, and key, and the info button opens the rest. From a track's menu (on iPhone and iPad, its info screen) you can set it as the backing track, set its recording key, correct its recording tempo and meter, Rename it, Replace it, or Delete it. Rename changes only the label everyone sees — it does not replace the file or drop practice audio already prepared in other keys. Tempo and meter corrections are shared with everyone and never change the arrangement's own tempo or the playback speed. Replace removes the old file before uploading the replacement; if the upload fails after removal, the old file is gone, so attach it again or choose another backing track. Delete removes the uploaded file for everyone on the arrangement.
Links are edited in place in the sheet on web; on iPhone and iPad, remove a link from its row menu or swipe, and add a new one from +.
The sheet shows storage usage and warns when storage is almost full. Both your storage and the owning group's storage can apply to a group upload. Storage, maximum file size, and track limits depend on the applicable plan; see Account settings.
On web, the practice player sits in the bottom toolbar in View and Edit modes and plays the backing track. On iPhone and iPad, the transport bar appears under the chart whenever the arrangement has a backing track, whether the song was opened from a setlist or from the Songs list.
Delete an uploaded track you no longer need, or ask someone with editing access to help. Deleting another member's upload may free group storage without freeing your personal allowance. Removing a recording link does not free uploaded-audio storage.
Removing an offline download only frees space on that device. It does not delete the shared upload or free its storage allowance. If the storage check fails, try again; your existing tracks remain visible. See Troubleshooting.
Charts have a Markup layer for your own performance marks. You can place text notes and draw freehand ink on the paged chart in Stage mode and in the PDF preview. Markup is saved for your account on that arrangement, so it follows you between devices but is not visible to other people who open the song. Stage paged view and PDF preview share marks anchored to the printed page layout; they are included in your PDF when annotated export is on. Older Stage marks drawn on screen-shaped pages remain saved but are not shown on printed pages. Marks you made on an iPad with Apple Pencil appear on the web as well. If two devices edit the same page, Akordo asks whether to Keep mine or Reload the other device's version.
Every save records a version for the song and, separately, for the arrangement you edited. Open History from the Actions menu.
Each entry shows when it was saved, who saved it, and what changed. On web it also shows the version number. Select an arrangement version to see a line-by-line comparison of the chart against the current version. On iPhone and iPad, History is a row in Song info and in Edit arrangement.
Choose Restore on any entry to bring it back. Restoring records a new version, so you can restore forward again if you change your mind.
Use the chart's Strumming controls to add a preset and name it for a section such as Verse or Chorus. Edit downstrokes, upstrokes, rests, muting, and accents, then save the pattern. Patterns span one or two bars and follow the arrangement's tempo and meter. Preview plays a synthesized rhythm; it does not transcribe an uploaded recording.
Show or hide patterns without changing the chart text or printed layout. Visibility is remembered on this device for the chart. On iPhone and iPad, Scroll shows patterns alongside the chart; Pages opens them in an overlay. Strum patterns do not appear in PDF exports.
Pattern data travels with the chart source and version history. If a pattern reports invalid data or an incompatible rhythm grid, repair it in Source or remove the affected pattern before saving visual edits. See ChordPro reference.
The metronome button sits in the Timing chip in View mode. It plays the arrangement's BPM and time signature. Set a BPM first, because the button stays disabled until the arrangement has a valid tempo between 20 and 300.
In View mode, start auto-scroll from the toolbar and adjust the speed with the slower and faster buttons. The speed you choose is remembered for that song. Auto-scroll is also available in Stage mode.
Press Perform to open the song full screen with large text, paged or scrolling layout, and keyboard or foot-pedal control. See Stage mode. On iPhone and iPad, every chart works this way: tap the chart to hide everything but the music, and switch between Scroll and Pages with the layout button.
The Repertoire Insights panel on a song shows its history in completed sets, including total plays, the key it was most often performed in, and the arrangement most often used. You can also record your private confidence rating from 1 to 5, fill in custom fields your group has defined, and attach links to licensed resources. Custom fields are searchable from Smart Views on the Repertoire page.
Move a song into a group so everyone in the group can open it. Open Share from the Actions menu, expand Ownership & permissions, and choose Move to group. Group roles decide who can edit. See Groups. On iPhone and iPad, choose the group as the Owner when you add a song; moving an existing song into a group is done on the web.
The same Share panel lets you invite one person by email with a role of Can edit or View only, whether or not you use groups. The owner can allow re-sharing so collaborators can invite others at or below their own access, or transfer ownership of the song to another person. On iPhone and iPad, open Song details › Members from the chart's More menu to invite someone, change a role, or remove someone.
Deleting a song moves it to Deleted in the library actions menu, where you can restore it or restore everything. On iPhone and iPad, swiping to delete a song acts at once and shows Undo; the song is also in Deleted songs under the Songs More menu. Deleted songs are kept for 30 days and then removed permanently. Deleted arrangements can be restored from the arrangement switcher in the same way.
Charts can be up to 10,000 characters. The number of songs, arrangements per song, and tunings per arrangement depend on your plan and are shown in Account settings.