# Button

<div align="left"><figure><img src="/files/FHzdRRLQdDTgLTp5KgaE" alt="" width="66"><figcaption><p>Button Element</p></figcaption></figure></div>

Use the **`Button`** element when you need the user to trigger an action on your page.&#x20;

This action can encompass a variety of tasks such as form submission or data processing.&#x20;

With [Page Flow](/app-editor/page-flow.md), you can define the desired actions. If you're working with forms, there is already a pre-configured Submit button element available to conveniently submit your form. Additionally a pre-configured Reset button is also available to clear the contents of all the field inputs.

***

## Options

The [Options tab](/app-editor/page-editor/page-element-settings.md#options-tab) settings for this element are described below:

### `Button Content`

Specify what you want the button to say using this setting. You can enter some simple HTML code here. We also support [Font Awesome 6](https://fontawesome.com/v6/search?o=r\&m=free) icons.

### `Button Look`

Select from a pre-defined list of background and text colors for the button look. For any other customizations see [here](/app-editor/page-editor/page-element-settings.md).

### `Button Size`

Select from a pre-defined list of sizes. For any other customizations see [here](/app-editor/page-editor/page-element-settings.md).

### `Button Action`

This is an advanced parameter that translates to the [Bootstrap](https://getbootstrap.com/docs/4.6/getting-started/introduction/) **`data-toggle`** attribute. The [Popup Menu Style1](/app-editor/page-editor/built-in-elements/popup-menu-style1.md), [Popup Menu Style2](/app-editor/page-editor/built-in-elements/popup-menu-style2.md)  and [Menubar Popup Menu](/app-editor/page-editor/built-in-elements/menubar-popup-menu.md) elements use this by setting the value to ***`dropdown`***. You can also use this to control a [Collapsible Area](/app-editor/page-editor/built-in-elements/collapsible-area.md) element by setting the value to ***`collapse`***.

### `Action Target`

This is an advanced parameter that translates to the [Bootstrap](https://getbootstrap.com/docs/4.6/getting-started/introduction/) **`data-target`** attribute. The value is set to the Element ID of the element to be controlled. To find the Element ID see [here](/app-editor/page-editor/page-element-settings.md#advanced-tab).

{% hint style="info" %}
The Element ID needs to be prefixed with a # character. This is also known as ID selector syntax. For more information click [here](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
{% endhint %}

### `Popup Menu Icon`

Enable this if you want a :arrow\_down\_small:arrow to appear next to the content to indicate that it will invoke a popup menu. The [Popup Menu Style1](/app-editor/page-editor/built-in-elements/popup-menu-style1.md), [Popup Menu Style2](/app-editor/page-editor/built-in-elements/popup-menu-style2.md)  and [Menubar Popup Menu](/app-editor/page-editor/built-in-elements/menubar-popup-menu.md) elements turn this setting on.


---

# 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://docs.zingy.ai/app-editor/page-editor/built-in-elements/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.
