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

# Forms overview

> Hosted signup forms and full page forms: what each kind does, where submissions go, and how a form moves from draft to live.

export const Screenshot = ({id, src, srcDark, alt, caption}) => {
  if (!src) {
    return <Placeholder id={id} kind="screenshot" label="Screenshot coming soon" description={alt} icon={<ImageIcon />} />;
  }
  return <figure className="brd-media" data-media-id={id}>
      <img className="brd-media-frame block dark:hidden" src={src} alt={alt} />
      <img className="brd-media-frame hidden dark:block" src={srcDark || src} alt={alt} />
      {caption && <figcaption className="brd-media-caption">{caption}</figcaption>}
    </figure>;
};

Forms let people add themselves to your contacts, or answer questions you ask. You build a form in
the dashboard and Brudcast hosts it on a public page at `https://forms.brudcast.com`. Anyone with the
link can fill it in, without an account.

<Screenshot id="ss-forms-overview-hero" alt="The Forms page with Live forms, Signups (30d) and Responses (30d) figures above a table of forms" />

## Two kinds of form

|                          | Signup form                                                                    | Full page form                                                                                     |
| ------------------------ | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| **What it's for**        | Growing a list: a newsletter, a waitlist                                       | Asking anything: event feedback, an RSVP, an application                                           |
| **Contact list**         | Always feeds one list                                                          | Optional. Pick one, or just collect answers.                                                       |
| **What it asks**         | An email address plus contact fields: name, phone, consent, your custom fields | Any of the [question types](/forms/create-a-form#question-types), across several pages if you like |
| **Confirmation email**   | On by default                                                                  | Available when the form adds to a list                                                             |
| **Where answers go**     | The contact, and the **Submissions** tab                                       | The **Responses** tab, and the contact when it adds to a list                                      |
| **Default button label** | Subscribe                                                                      | Submit                                                                                             |

You choose the kind when you create a form. You can switch until the form is published; after that
the kind is fixed. To start from the other kind, duplicate the form and switch the copy.

Forms are part of the Email product. Without access to it, the **Forms** page asks you to subscribe
first.

## What happens to a submission

```mermaid theme={"system"}
flowchart TD
  S["Someone submits the form"] --> K{"Does the form add to a list?"}
  K -- "No" --> R["Response saved: Received"]
  K -- "Yes" --> D{"Double opt-in?"}
  D -- "Off" --> C["Contact created or updated and subscribed, consent recorded"]
  D -- "On" --> P["Awaiting confirmation, confirmation email sent"]
  P -- "Clicks the link" --> C
  P -- "No click in 7 days" --> X["Expired"]
```

Before any of this, every submission goes through the spam checks. A submission that fails one is
recorded as **Rejected**. See
[Submissions and responses](/forms/submissions-and-responses).

## Form statuses

| Status      | Label      | Meaning                                                                    |
| ----------- | ---------- | -------------------------------------------------------------------------- |
| `draft`     | **Draft**  | Being built. The link doesn't accept submissions.                          |
| `published` | **Live**   | The link accepts submissions.                                              |
| `paused`    | **Paused** | Unpublished, by you or automatically. The link doesn't accept submissions. |

Deleted forms disappear from the list. Their submissions and consent records are kept.

## The Forms page

Go to **Contacts > Forms**. The table shows each form's **Name** with the list it feeds (or **Not
added to a list**), its **Type**, **Status**, **Opt-in** (**Double**, **Single**, or `-` for a form
with no list) and when it was **Updated**. Filter by type with **All forms**, **Signup form** or
**Full page form**.

Each row's menu has **Copy link**, **Open public form** (for live forms), **Duplicate** and
**Delete**. See [Publish and share](/forms/publish-and-share).

## Rules and limits

| Rule                       | Value                      |
| -------------------------- | -------------------------- |
| Lists a form can feed      | One                        |
| Questions and layout items | Up to 50                   |
| Confirmation link lifetime | 7 days                     |
| Submissions per hour       | 100 by default, adjustable |
| Uploaded file size         | Up to 10 MB each           |

## Related

<Columns cols={2}>
  <Card title="Create a form" icon="clipboard-list" href="/forms/create-a-form">
    Build and publish your first form.
  </Card>

  <Card title="Publish and share" icon="share-2" href="/forms/publish-and-share">
    Go live and share the link or QR code.
  </Card>

  <Card title="Submissions and responses" icon="inbox" href="/forms/submissions-and-responses">
    Read what comes in, and tune the spam checks.
  </Card>

  <Card title="Lists" icon="list" href="/contacts/lists">
    The lists your signups join.
  </Card>
</Columns>
