> ## Documentation Index
> Fetch the complete documentation index at: https://docs.webstorio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forms & surveys

> Build contact forms and surveys, collect submissions, and embed them on your Webstorio pages.

**Form & Survey** lets you build forms in the dashboard and collect responses without a third-party form tool.

**Available on:** Starter plan and above (5 forms on Starter; unlimited on Growth+).

## Step 1 — Create a form

1. Open your project → **Forms**.
2. Click **Create form**.
3. Name it (e.g. `Contact`, `Newsletter signup`).
4. Add fields:

| Field type | Good for                      |
| ---------- | ----------------------------- |
| Text       | Name, short answers           |
| Email      | Contact email (validated)     |
| Textarea   | Messages, feedback            |
| Dropdown   | Country, topic selection      |
| Checkbox   | Consent, multi-select options |

5. Save. Note the form **key** (e.g. `contact`) — pages use this to load and submit the form.

## Step 2 — Embed on a page

### Using the AI builder

In the page editor:

* *"Add a contact form using my Contact form"*
* *"Create a newsletter signup section with email field wired to my Newsletter form"*

The AI renders the form and connects submission to your backend.

### What happens on submit

1. Visitor fills out fields and clicks submit.
2. Data is validated against your schema.
3. A **submission** is stored in **Forms → \[your form] → Submissions**.
4. The page can show a success message or redirect.

## Step 3 — Review submissions

1. Open **Forms** → select your form → **Submissions**.
2. Browse entries with timestamps and field values.
3. Export or process manually (API export options are on the roadmap).

## Limits by plan

| Plan    | Forms     | Submissions / month |
| ------- | --------- | ------------------- |
| Free    | —         | —                   |
| Starter | 5         | 1,000               |
| Growth+ | Unlimited | Unlimited           |

## Tips for better forms

<Tip>
  **Keep it short:** Contact forms with 3–4 fields convert better than long
  surveys on landing pages.
</Tip>

<Tip>
  **Clear labels:** Use plain field labels — "Your email" not
  "email\_address\_v2".
</Tip>

<Warning>
  Don't collect sensitive data (passwords, full payment cards) in custom forms.
  Use dedicated auth and payment features when they ship.
</Warning>

## For developers and agents

Editing page code yourself? Use `window.webstorio` form methods (`getFormSchema`, `submitForm`) in your pages. Public sites typically allow **submit**; reading submissions is usually dashboard-only unless you build authenticated admin views.

→ Methods, parameters, and examples: [Forms SDK reference](/api-reference/sdk/forms)

Agents can create and update forms via [MCP](/developer/connect-mcp).