> For the complete documentation index, see [llms.txt](https://guide.tonaly.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.tonaly.app/songwriting/edit-a-chord/get-a-chord-suggestion.md). # Get a chord suggestion {% embed url="" %} > First, [**enter the chord edit overlay**](/songwriting/edit-a-chord/add-optional-tones-to-a-certain-chord.md) or select a bar and shake your device ### ▶️ **Chord suggestions** Tap the shuffle icon or [**shake your device**](/settings/app-settings/shake-gesture.md) for a chord suggestion.
**👉 You will enter the suggestions view**
This horizontal list will display chord suggestions. If you have a bar selected, when asking for a suggestion, the app will have a look at the previous and next chord and will try to find matching chords. Also, it will display the relation of the chord to the next or previous chord. 👉 **The suggestions are grouped** in: * **Top suggestions** * This can be leading chords that fit the previous and the next chord. Those are mostly not within the key.
* **In key chords** * Suggestions that are within the key.
* **Out of key chords** * Suggestions that are not within the key and could give a new flavor to your song. **👉 The line below the chord** will indicate how relevant this chord is related to the rest of your song. ▶️ Tap on the "shuffle icon" 🔀 or shake your device to get another suggestion.# ▶️ Tap on the "back icon" 🔙 to edit the selected chord. > You can add more chords that are not within the key with the[ **"Borrow chord"**](/songwriting/step-out-of-the-key/in-the-app-borrow-a-chord.md) functionality. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://guide.tonaly.app/songwriting/edit-a-chord/get-a-chord-suggestion.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.