# Forms

> Build popup, flyout, banner, full-page and embedded sign-up forms in the dashboard, publish them to your site with one script tag, and collect submissions.

Forms are sign-up forms you design in the Emailit dashboard and show on your website. You build a form visually, publish it, and add one script tag to your site, and Emailit stores every submission for you.

> **Forms is in early access:** Forms isn't available in every workspace yet. If **Forms** shows a **Soon** badge in your dashboard sidebar and can't be opened, it isn't enabled for your workspace. [Contact support](/contact/) if you'd like early access.

## How it works

1. **Create a form** under **Email Marketing → Forms** and pick its type.
2. **Design it** in the builder: add text, images, buttons and input fields, split it into steps and style it. See [Build a form](/docs/forms/build/).
3. **Publish it.** Only live forms appear on your site.
4. **Install the script** once on every page of your site. Popups, flyouts, banners and full-page forms then appear by themselves. Embedded forms also need a placeholder where they should render. See [Install forms](/docs/forms/install/).
5. **Review submissions** on the form's page.

## Form types

| Type | How it appears |
| --- | --- |
| **Popup** | A dialog in the middle of the page over a dimmed overlay. Opens a few seconds after the page loads. |
| **Full page** | Covers the whole page. Opens a few seconds after the page loads. |
| **Flyout** | Slides in at the bottom right, bottom left or bottom of the page. Opens a few seconds after the page loads. |
| **Banner** | A bar across the top or bottom of the page. Shows as soon as the page loads. |
| **Embed** | Renders inline, inside your page content, wherever you place its placeholder. |

You pick the type when you create the form and can change it later in the builder's **Styles** panel. Each page load shows at most one popup, flyout or full-page form, plus any live banners and embeds.

## Statuses

| Status | Meaning |
| --- | --- |
| **Draft** | The form is saved but not shown on your site. New forms start as drafts. |
| **Live** | The form is published and shows wherever the script is installed. |

To publish, a form needs at least one form step and a success step. **Unpublish** returns a live form to draft and removes it from your site.

## Submissions

Every time a visitor submits a form, Emailit stores the submission with the value of each field, keyed by the field's property name, and details about where it came from, such as the page URL and referrer. The form's page lists them under **Recent submissions**, newest first.

Submissions are stored with the form only. They don't create contacts or add anyone to an audience yet, so a form doesn't grow your audiences by itself. To add sign-ups to an audience today, use an audience's [subscribe URL](/docs/audiences/subscribe-url/) or the [Subscribers API](/docs/api-reference/audiences/subscribers/).

Deleting a form permanently deletes its submissions too.

## The Forms list

**Email Marketing → Forms** lists your forms with their **Name**, **Type**, **Status** and **Updated** time, with search.

- **Create form** asks for a **Name** and a **Type**, then opens the new form.
- **Install** shows the script tag for your site.
- The row menu has **Edit**, **Rename** and **Delete**.

On a form's page you'll find **Publish** or **Unpublish**, **Edit form** to open the builder, a **Details** card with the number of steps and the form's **Public token**, the **Recent submissions** table and an **Installation** card with the code for this form.

## Use the API

The [Forms API](/docs/api-reference/forms/) lets you [create](/docs/api-reference/forms/create/), [retrieve](/docs/api-reference/forms/get/), [update](/docs/api-reference/forms/update/), [list](/docs/api-reference/forms/list/) and [delete](/docs/api-reference/forms/delete/) forms, [publish](/docs/api-reference/forms/publish/) and [unpublish](/docs/api-reference/forms/unpublish/) them, and [reset the public token](/docs/api-reference/forms/reset-token/). Forms have `frm_` IDs, a `type` (`popup`, `full_page`, `flyout`, `embed` or `banner`), a `status` (`draft` or `live`) and the full builder `definition`. Publishing a form without a form step and a success step returns `422`.

Submissions are available in the dashboard only.

## Next steps

  - [Build a form](/docs/forms/build/): Use the builder to design steps, fields and styles.
  - [Install forms](/docs/forms/install/): Add the script to your site and place embedded forms.

---
Source: https://emailit.com/docs/forms/