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.
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:
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. Click it to open the switcher. 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.
Click 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 arrangement's key. Capo is saved with the arrangement's active tuning.
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.
A vocal tuning is a saved transpose and capo combination with a name. 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.
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. 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.
Links and uploaded audio belong to an arrangement. Open the arrangement you want to practice: on web, expand the details panel under the song header in Edit mode; on iPhone or iPad, open the arrangement editor. A setlist uses the audio of its selected arrangement.
Use Recording links for a YouTube video or another recording on the web. Any web address works; YouTube links get a title automatically. Each arrangement can hold up to 20 links.
Akordo stores the address. It does not upload the video or turn it into a pitchable audio file. Links do not use your uploaded-audio storage allowance.
Uploaded tracks are shared with everyone who can access the arrangement. Audio changes take effect immediately: uploads and deletions do not wait for the arrangement form’s Done or Save action.
The Audio section 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.
To swap a track, choose Replace. Akordo checks the new file before removing the old one, then removes the old file before uploading the replacement. If the upload fails after removal, the old file is gone; attach it again or choose another backing track. Delete removes the uploaded file for everyone on the arrangement.
On web, a practice player appears in the bottom toolbar in View and Edit modes. On iPhone and iPad, use the arrangement’s audio playback controls to practice.
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. Marks made in the PDF preview belong to the printed page layout and are included in your PDF when annotated export is on. Marks made in Stage mode belong to the screen-shaped pages and are not printed. 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 the version number, when it was saved, why, and which fields changed. Select an arrangement version to see a line-by-line comparison of the chart against the current version.
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.
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.
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.
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.
Deleting a song moves it to Deleted in the library actions menu, where you can restore it or restore everything. 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.