# Form

<div align="left"><figure><img src="https://3401585094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmnBepgycwgisXr9ya1N4%2Fuploads%2FYOIvLvOITCX0i8xK5c3H%2Fimage.png?alt=media&#x26;token=1b5d7bfd-b2cc-4504-807e-ec318c4ae6c0" alt="" width="69"><figcaption><p>Form Element</p></figcaption></figure></div>

{% hint style="info" %}
To utilize the Form element, it is necessary to have an existing [form page](https://docs.zingy.ai/app-editor/pages-and-forms/create-a-form) already created within your application.
{% endhint %}

Use the **`Form`** element to embed a form in your page.

&#x20;The Form is a widget element with the following characteristics:

* It exhibits content dynamically upon page load. Within the page editor, it will showcase a placeholder that denotes the designated content area. To preview the element's appearance on your page, utilize the [Page Preview](https://docs.zingy.ai/app-editor/page-editor/page-preview) feature.
* It will span the entire width of their parent element horizontally.

***

## Example

The image below shows a form element placed inside in the right layout column. For demonstration the left layout column is styled with a green dashed border, and the right layout column is styled with a red dashed border.&#x20;

In the page editor, the form element is rendered with a place holder as shown below.

<figure><img src="https://3401585094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmnBepgycwgisXr9ya1N4%2Fuploads%2F9faagljeNzDqn1hPwbRZ%2Fimage.png?alt=media&#x26;token=eead51f0-cf12-4a9f-960c-d488265dce4b" alt=""><figcaption><p>Example showing Form element placeholder in the page editor.</p></figcaption></figure>

When the page is previewed or loaded by the user, the form element is rendered with the specified form page.

<figure><img src="https://3401585094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmnBepgycwgisXr9ya1N4%2Fuploads%2FYSxsmIsOxoOWPyqePIis%2Fimage.png?alt=media&#x26;token=007a9698-dd09-42df-9a3f-c9fd40604674" alt=""><figcaption><p>Example showing Form element when the page is loaded</p></figcaption></figure>

***

## Options

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

### `Form URL (AppDomain/forms/)`

Specify the name of the form page or the [Publishing URL slug](https://docs.zingy.ai/page-settings#page-url) of the form page.

### `Allow Multiple Uses`

When turned ON, the embedded form will reset back to its initial state after it has been successfully submitted.&#x20;

When turned OFF, the embedded form can only be used once per page load, and will display a status message after the form is submitted.


---

# 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/form.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.
