# Button

The button is basically a container *(with a background or a border)* containing a text.

#### Available properties:

| Property                                                                                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **payload**                                                                                                                                        | [Same as Text Payload documentation](/rest-api/generation/element-properties/text.md#payload)                                                                                                                                                                                                                                                                                                                                                                                       |
| **color**                                                                                                                                          | [Same as Text Color documentation](/rest-api/generation/element-properties/text.md#color)                                                                                                                                                                                                                                                                                                                                                                                           |
| **background\_color**                                                                                                                              | Same as `color`                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><strong>font</strong><br><strong>font\_weight</strong></p>                                                                                      | [Same as Text Font documentation](/rest-api/generation/element-properties/text.md#font)                                                                                                                                                                                                                                                                                                                                                                                             |
| **font\_size**                                                                                                                                     | Number. **Force font size in pixels** (must be > 1)                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **line\_height**                                                                                                                                   | Number. Force line height in percentage (must be > 1). *This parameter is only applied when the text is a multiline one.*                                                                                                                                                                                                                                                                                                                                                           |
| <p><strong>shadow\_color</strong><br><strong>shadow\_blur</strong><br><strong>shadow\_offset\_x</strong><br><strong>shadow\_offset\_y</strong></p> | [Go to Shadow documentation](/rest-api/generation/element-properties.md#shadow)                                                                                                                                                                                                                                                                                                                                                                                                     |
| **auto\_resize**                                                                                                                                   | <p>Boolean: Automatically adjusts the text size to fit within its container <br><em>(If set to true, <strong><code>min\_font\_size</code></strong> must be defined)</em></p>                                                                                                                                                                                                                                                                                                        |
| **min\_font\_size**                                                                                                                                | <p>Number: Specifies the minimum font size allowed when auto-resizing text. <br><em>(auto\_resize must be set to <strong>true</strong>)</em></p>                                                                                                                                                                                                                                                                                                                                    |
| **text\_transform**                                                                                                                                | <p>String: Force the text to be transformed to one of the following formats:</p><ul><li>"<code>uppercase</code>" – All letters become uppercase (e.g., EXAMPLE).</li><li>"<code>lowercase</code>" – All letters become lowercase (e.g., example).</li><li>"<code>titlecase</code>" – The first letter of each word is capitalized (e.g., Example Text).</li><li>"<code>capitalize</code>" – Only the first letter of the entire text is capitalized (e.g., Example text).</li></ul> |

#### Example:

<table data-header-hidden><thead><tr><th width="376"></th><th></th></tr></thead><tbody><tr><td><code>"payload": "My click to action"</code><br><code>"color": "#FFFFFF"</code><br><code>"background_color": "#1A47FF"</code></td><td><img src="/files/FbnnM5UUWjBNidfOv4x7" alt=""></td></tr><tr><td><code>"payload": "My click to action"</code><br><code>"color": "cmyk(0,0,0,0,100)"</code><br><code>"background_color":"cmyka(90,72,0,0,100)"</code></td><td><img src="/files/FbnnM5UUWjBNidfOv4x7" alt=""></td></tr></tbody></table>


---

# 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://developers.abyssale.com/rest-api/generation/element-properties/button.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.