# \[chordpress]

The `[chordpress]` shortcode assumes that the text wrapped in its tags is valid ChorPro format. It will render the text and display it “pretty” on your page.

## Format

{% code overflow="wrap" %}

```
[chordpress parameter="value" ...]your ChordPro text here[/chordpress]
```

{% endcode %}

## Parameters

| Parameter           | Description                                                                                                                                                                                                                                                                                                                                                                            | Default        |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| float               | <p>Forces the output div element to float. This can be useful depending on other elements on your page. Supported values:</p><ul><li>left</li><li>right</li><li>none</li><li>inherit</li></ul>                                                                                                                                                                                         | none           |
| format              | <p>Tells the plugin whether to render the text or not. There maybe cases where you actually just want to display the original ChordPro text. </p><p></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                       | yes            |
| harmonica           | <p>Tells the plugin that the chords are to be interpreted as harmonica notes. The page will then also show a list box that allows to switch between harmonica types.<br><br>Supported values are:</p><ul><li>tremolo</li><li>diatonic</li><li>chromatic</li></ul>                                                                                                                      | \<no default>  |
| hbnotation          | <p>This parameter allows to display chords in H/B notation: H is used instead of B, B is used insetad of Bb. This notation is used in some European countries. Read more about it <a href="https://sayandsound.lewe.com/note-h/">here</a>.</p><p></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                          | no             |
| hidechords          | <p>Overrides the global setting and hides all chords in the rendered song, incl. the chord sheet.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                      | Global setting |
| hidecomments        | <p>Overrides the global setting and hides all comment sections.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                        | Global setting |
| hidecomposer        | <p>Overrides the global setting and hides the composer information.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                    | Global setting |
| hidesubtitle        | <p>Overrides the global setting and hides the subtitle.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                                | Global setting |
| hidetitle           | <p>Overrides the global setting and hides the title.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                                   | Global setting |
| hideyear            | <p>Overrides the global setting and hides the year.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                                    | Global setting |
| hidetranspose       | <p>Overrides the global setting and hides the transpose drop down.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                     | Global setting |
| hideprint           | <p>Overrides the global setting and hides the print button.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                            | Global setting |
| interactive         | <p>Tells the plugin to activate interactive mode. A drop down list with 11 semitone steps will be shown to the right of the song title.</p><p></p><p>Selecting a value from that list will transpose the chords by that many semitone steps up. E.g. an ‘Em’ chord transposed 5 steps up will become an ‘Am’ chord.</p><p></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul> | no             |
| showchordsheet      | <p>Overrides the global setting and shows the chord sheet.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                                             | Global setting |
| showchordsheetontop | <p>Overrides the global setting and shows the chord sheet on top of the song.<br></p><p>Supported values:</p><ul><li>no</li><li>yes</li></ul>                                                                                                                                                                                                                                          | Global setting |
| transpose           | Enter a positive or negative number for the amount of semitones to transpose the chords.                                                                                                                                                                                                                                                                                               | 0              |


---

# 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://lewe.gitbook.io/lewe-chordpress/shortcodes/chordpress.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.