> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.webflow.com/designer/reference/forms/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server.

# Forms

> Learn how to create and manage forms with the Designer API.

Webflow Forms enable users to capture and collect information from visitors on a site.

## Creating a form

Use the `FormForm` [element preset](/designer/reference/element-presets) to create a form.

```javascript
// Get the currently selected element
let el = await Webflow.getSelectedElement();

// Create a form element
let form = await el.after(webflow.elementPresets.FormForm);

```

When you create a form using the `FormForm` preset, it automatically generates a complete [form structure](#form-structure) with default form fields, as well as a success and error message.

![Form Element Preset](/_fern-img/45b5e84f6c1581d2b6acb9531d5355689eda82ff445e762e1acc3cfe7bc38cab.webp)

## Form structure

A Webflow form consists of several nested elements that work together:

| Element              | Description                                                                 | Parent Element |
| -------------------- | --------------------------------------------------------------------------- | -------------- |
| `FormWrapper`        | The outermost container element that encapsulates the entire form structure |                |
| `FormForm`           | The main form element containing all form fields and inputs                 | `FormWrapper`  |
| `FormSuccessMessage` | The success message after successful form submission                        | `FormWrapper`  |
| `FormErrorMessage`   | The error message if form submission fails                                  | `FormWrapper`  |
| `FormInput`          | An individual form field.                                                   |                |
| `FormBlockLabel`     | The label for a `FormInput`                                                 | `FormInput`    |
| `FormButton`         | The submit button for the form                                              | `FormForm`     |

## Form inputs

Form inputs are the individual fields that collect user information. It's recommended to create a wrapper to contain each input and it's corresponding [label](#form-labels).

You can create form inputs using the following element presets:

* `FormTextInput`
* `FormTextarea`
* `FormSelect`
* `FormCheckboxInput`
* `FormRadioInput`

It's a best practice to wrap each input and its corresponding label (e.g. `FormBlockLabel`) in a container element, such as a `DivBlock`, to keep them organized.

**Example**

**`Inline`**

```javascript title="Inline"
// Get the currently selected element
let el = await Webflow.getSelectedElement();

// Create a form element
let formWrapper = await el.after(webflow.elementPresets.FormForm);

// Add a text input with a label
let formWrapperChildren = await formWrapper.getChildren(); // Get the form element
let formInputs = formWrapperChildren[0]; // Get the form element
let inputWrapper = await formInputs.append(webflow.elementPresets.DOMElement); // Create a wrapper for the input and label
let label = await inputWrapper.append(webflow.elementPresets.FormBlockLabel); // Create a label
let input = await inputWrapper.append(webflow.elementPresets.FormTextInput); // Create a text input

```

### Form labels

Each input should have a label that describes the information it collects. Create a label using the `FormBlockLabel` element preset to label each input.

## Methods

### Form element methods

> **Note**
>
> The methods documented below apply specifically to the `FormForm` and
> `FormWrapper` elements.

The Form Element supports the following specific methods:

#### [Get form name](/designer/reference/form-element/get-form-name)

Retrieves the name of the form.

#### [Set form name](/designer/reference/form-element/set-form-name)

Sets the name of the form.

#### [Get form settings](/designer/reference/form-element/get-form-settings)

Retrieves the settings of the form.

#### [Set form settings](/designer/reference/form-element/set-form-settings)

Sets the settings of the form.

### Form input methods

The following methods apply to form input elements:

#### [Get required status](/designer/reference/form-element/get-required-status)

Retrieves the required status of a form input.

#### [Set required status](/designer/reference/form-element/set-required-status)

Sets the required status of a form input.

#### [Get input name](/designer/reference/form-element/get-name-input-field)

Retrieves the name of the input field.

#### [Set input name](/designer/reference/form-element/set-name-input-field)

Sets the name of the input field.

#### [Get input type](/designer/reference/form-element/get-type-input-field)

Retrieves the type of the input field.

Only supported by `FormTextInput`.

#### [Set input type](/designer/reference/form-element/set-type-input-field)

Sets the type of the input field.

Only supported by `FormTextInput`.

## Properties

| Property           | Description                                             | Type      | Example                                                 |
| ------------------ | ------------------------------------------------------- | --------- | ------------------------------------------------------- |
| `id`               | The unique identifier for the form.                     | `object`  | `{component: "64c813...", element: "5edf8e59-71f9..."}` |
| `type`             | The type of the element.                                | `string`  | `"FormForm" \|\| "FormWrapper`                          |
| `children`         | Indicates if the element can contain child elements.    | `boolean` | `true`                                                  |
| `customAttributes` | Indicates if the element can contain custom attributes. | `boolean` | `true`                                                  |
| `styles`           | Indicates if the element can contain styles.            | `boolean` | `true`                                                  |
| `textContent`      | Indicates if the element can contain text content.      | `boolean` | `false`                                                 |
| `appConnections`   | Indicates if the element can contain app connections.   | `boolean` | `true`                                                  |

> Learn how to create and manage forms with the Designer API.

## Docs

- [Get Form Name](https://developers.webflow.com/designer/reference/form-element/get-form-name.md): Retrieves the name of the form.
- [Set Form Name](https://developers.webflow.com/designer/reference/form-element/set-form-name.md): Sets the name of the form.
- [Get Form Settings](https://developers.webflow.com/designer/reference/form-element/get-form-settings.md): Retrieves the settings of the form.
- [Set Form Settings](https://developers.webflow.com/designer/reference/form-element/set-form-settings.md): Sets the settings of the form.
- [Form Inputs](https://developers.webflow.com/designer/reference/form-inputs.md): An overview of form input elements and how to create and manage them with the Designer API.
- [Get Required Status](https://developers.webflow.com/designer/reference/form-element/get-required-status.md): Retrieves the required status of a form input.
- [Set Required Status](https://developers.webflow.com/designer/reference/form-element/set-required-status.md): Sets the required status of a form input.
- [Get input name](https://developers.webflow.com/designer/reference/form-element/get-name-input-field.md): Retrieves the name of the input field.
- [Set input name](https://developers.webflow.com/designer/reference/form-element/set-name-input-field.md): Sets the name of the input field.
- [Get input type](https://developers.webflow.com/designer/reference/form-element/get-type-input-field.md): Retrieves the type of the input field.
- [Set input type](https://developers.webflow.com/designer/reference/form-element/set-type-input-field.md): Sets the type of the input field.