# Get a chord suggestion

{% embed url="<https://youtu.be/w3X6lapz0OE?t=319>" %}

> 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.

<div align="left"><img src="/files/-LzCS5p-hI9v7L-o79v7" alt=""></div>

**👉 You will enter the suggestions view**

<div align="left"><img src="/files/-M3zQB07mfJv59ZkruZ-" alt=""></div>

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.<br>
* **In key chords**
  * Suggestions that are within the key.<br>
* **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.&#x20;

> 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: 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:

```
GET https://guide.tonaly.app/songwriting/edit-a-chord/get-a-chord-suggestion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
