Troubleshooting & FAQ

Available without signing in.

Common issues and how to solve them.

I can't log in

Check these first:

Email spelling: Make sure you're using the exact email you registered with
Password: Passwords are case-sensitive
Account exists: If you're not sure, try registering — if the email is taken, you have an account

If you still can't log in:

Use the "Forgot password?" link on the login page
Check your email for the reset link (check spam/junk if you don't see it)
Click the link and set a new password

I didn't receive the verification email

If you just registered but didn't get the verification email:

Check spam/junk folders: Sometimes emails get filtered
Wait a few minutes: Email delivery can be delayed
Check the email address: Make sure you registered with the right email
Request a new verification: Try logging in — you'll see an option to resend the verification email

If you're still stuck, the verification may have expired. Contact support for help.

My password reset link doesn't work

Password reset links expire after a period of time and can only be used once.

If the link expired: Request a new password reset
If you already used it: The link is one-time use — request a new one
If the link looks corrupted: Make sure you're clicking the full link (sometimes email clients break long URLs)

I want to change my email

See Account settings for the email change process. You'll need:

Access to the new email address (to verify)
Your current password (to confirm it's you)

Chart display issues

Chords aren't aligned with lyrics

ChordPro uses a different approach than manually spaced charts. Chords attach to syllables, not positions.

Common causes:

Missing brackets: Make sure chords are in [brackets]
Bracket typos: Check for [chord] vs (chord) or {chord}
Unclosed brackets: Every [ needs a matching ]

Example fix:

Wrong: (C)Hello (G)world
Right: [C]Hello [G]world

Section headers aren't rendering

Section headers like VERSE 1 or CHORUS should highlight automatically.

Check:

The header is on its own line
There's no text before it on that line
It's spelled correctly (case-insensitive)

If you want literal text: Prefix with \ to prevent parsing:

\VERSE 1

The transpose directive isn't working

TRANSPOSE KEY +2 requires exact syntax:

Must include + or - before the number
Must be on its own line
Case-insensitive, but spacing matters

Correct:

TRANSPOSE KEY +2
TRANSPOSE KEY -3

Incorrect:

TRANSPOSE KEY 2      (missing sign)
Transpose key +2     (lowercase is fine, but check spacing)
TRANSPOSE KEY + 2    (extra space)

Comments aren't showing

Comment syntax depends on the type:

{c:Comment text} — visible comment that displays in the chart
# Comment text — private comment that's hidden

If your comment isn't showing, check which syntax you used.

PDF export problems

The PDF layout looks wrong

PDF exports are formatted for standard printing. If something looks off:

Font size: Reduce font size in the export options for more content per page
Wide content: Long lines may wrap awkwardly — consider editing the chart
Column breaks: Add COLUMN_BREAK to force content into the next column

Content is cut off

Margins: PDFs have fixed margins — if content is at the edge, it may be cut
Song length: Very long songs may span multiple pages — this is expected

The PDF is blank

This usually means the chart has no renderable content. Check:

The chart has actual lyrics/chords (not just metadata)
Chord syntax is correct
There are no syntax errors preventing rendering

Group and permission issues

I can't edit a song in my group

Your permission level controls what you can do:

Viewer: Can view but not edit
Editor: Can create and edit songs
Owner: Full access

Ask the group owner to upgrade your role if you need edit access.

I can't see a group's songs

If you were added to a group but can't see its content:

Refresh the page: Sometimes the UI needs a moment to sync
Check your membership: Go to the group settings to verify you're listed
Verify the content exists: Ask a groupmate if the song/setlist is actually in the group

Someone left and we lost access

If the group owner leaves without transferring ownership:

The group still exists
Editors can still edit content
No one can change membership (invite/remove) or delete the group

To resolve this, contact support with the group name and details.

Mobile and browser issues

The app is slow on my phone

Akordo is optimized for modern browsers, but mobile performance can vary:

Use the latest browser: Update Safari, Chrome, or Firefox
Clear cache: Old cached data can slow things down
Check connection: Slow networks affect sync time
Close other tabs: Free up memory

Features don't work in my browser

Akordo supports the last two major versions of:

Chrome
Firefox
Safari
Edge

If you're using an older browser or a less common one:

Update to the latest version
Try a supported browser

I see "Your app is being rebuilt" constantly

This message appears during development when the app is recompiling. It should disappear within seconds once the build finishes.

If it persists:

Refresh the page: Sometimes the UI doesn't update properly
Check your connection: Network issues can interrupt the rebuild detection
Clear cache and refresh: Hard refresh with Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)

My changes aren't saving

If edits seem to disappear:

Check your connection: Offline changes may not sync
Look for error messages: Save failures usually show a notification
Try again: Sometimes a momentary network blip causes issues

If problems persist, try:

Signing out and back in
Clearing your browser cache
Using a different browser

Something else?

If your issue isn't covered here:

Check the relevant documentation for the feature you're using
Try the basic troubleshooting steps: refresh, clear cache, try another browser
If you're still stuck, reach out with details about what happened and what you expected

When reporting issues, include:

What you were trying to do
What actually happened
Any error messages you saw
Your browser and device