> For the complete documentation index, see [llms.txt](https://docs.supademo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supademo.com/customize/chapters/forms-and-lead-capture.md).

# Forms & Lead Capture

Add a lead capture form to any Supademo: build up to 7 fields from 9 field types, gate access by business email or domain, and sync responses to your CRM.

Native forms are lead capture forms built into your Supademo as a [Chapter](https://docs.supademo.com/customize/chapters). Viewers fill in the form mid-demo (or before it starts), and every response is emailed to you, saved in your Supademo analytics, and optionally synced to your CRM. This page covers how to build one. For where forms fit in your funnel, start with the [Capture Leads](https://docs.supademo.com/capture-leads) overview. [Showcases](https://docs.supademo.com/share/share-multiple-demos/showcase-collection/showcase-chapters.md) use the same form as a gate in front of the whole collection.

The walkthrough below shows a form being created from start to finish.

{% @supademo/embed url="<https://app.supademo.com/demo/cm8hvkpxi02ak20v2kbui6apg>" demoId="cm8hvkpxi02ak20v2kbui6apg" %}

## How to create a form

1. Open your Supademo in the editor and add a **Chapter** anywhere in the demo, then choose the **"Form"** option.
2. Add up to **7 form fields**, choosing a type for each: Text input, Email, Phone, Textarea, Dropdown, Checkbox, Multi-select, Date, or Number. Drag dropdown options to reorder them.
3. Mark each field as **required or optional**. For phone fields, turn on **"Require valid phone numbers"** so submissions are validated before they go through.
4. Set the form-level access controls: decide whether viewers can skip the form, and whether to limit submissions to business email addresses only (both covered below).
5. Click **Save** to go live with your form.

Viewers see a labelled form layout, and invalid entries show inline errors next to the field, so respondents can correct mistakes without losing their other answers.

## Field types and validation

Forms support nine field types, and any field can be marked required or optional independently:

| Field type       | Best for                                               | Options and validation                                             |
| ---------------- | ------------------------------------------------------ | ------------------------------------------------------------------ |
| **Text input**   | Names, companies, short answers                        | Single line of text                                                |
| **Email**        | Email addresses                                        | Checked by email verification; works with **Business Emails Only** |
| **Phone**        | Phone numbers                                          | Enable **Require valid phone numbers** to validate entries         |
| **Textarea**     | Longer free-form answers                               | Multiple lines of text                                             |
| **Dropdown**     | Segmentation questions like role or company size       | One choice from your list of options; drag to reorder options      |
| **Checkbox**     | A single confirmation, such as consent to be contacted | One box the viewer ticks                                           |
| **Multi-select** | Questions with more than one answer, such as interests | Several choices from your list of options                          |
| **Date**         | Dates such as a target launch or renewal               | Date picker                                                        |
| **Number**       | Numeric answers like team size or seat count           | Accepts numeric input                                              |

A form can hold up to 7 fields in total. Ask only for what you'll act on, and use Dropdown or Multi-select where you want clean, comparable answers for segmentation.

## Form access controls

Forms double as an access gate for your demo. These controls determine who gets through:

* **Skip Form** (toggle): viewers can bypass the form entirely. Turn this off to make the form a hard gate.
* **Business Emails Only** (toggle): restricts demo access to company email addresses, filtering out personal addresses like Gmail.

<figure><img src="https://3896040775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL3ayyYPPw0hy6Yn2UhX0%2Fuploads%2FqQfktPlDfi2XAB4Xo27D%2Fimage.png?alt=media&#x26;token=c83f5039-f5ca-4f7f-8d62-e97076bac4f3" alt=""><figcaption></figcaption></figure>

* **Blacklist/Whitelist Emails**: control access using custom domain lists. Type domains separated by commas into the textbox provided. The lists scale to hundreds of domains, so you can block competitors or restrict a demo to specific customer accounts.

{% @supademo/embed url="<https://app.supademo.com/demo/cmfwq676y3l8710k8sx7f2mkg>" demoId="cmfwq676y3l8710k8sx7f2mkg" %}

{% hint style="info" %}
Note: Whitelist allows only specified domains; Blacklist blocks specified domains
{% endhint %}

Submitted email addresses also go through **external email verification**, so invalid addresses are caught before they reach your lead list.

## Where responses go

Every submission lands in three places automatically, with an optional fourth use:

**1. Email notification.** Individual responses are sent to you via email as they come in.

<figure><img src="https://3896040775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL3ayyYPPw0hy6Yn2UhX0%2Fuploads%2F905C7Cj7Gx0Xfe1WyLOq%2Fimage.png?alt=media&#x26;token=11b69265-cc72-4dab-978d-45b4e286aeda" alt=""><figcaption></figcaption></figure>

**2. Lead Data analytics.** All responses are saved under the **Lead Data** tab of your Supademo Analytics, alongside each viewer's demo engagement.

<figure><img src="https://3896040775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL3ayyYPPw0hy6Yn2UhX0%2Fuploads%2F8LQdD9NVObw60ilKENKd%2Fimage.png?alt=media&#x26;token=7bc663e5-5f5b-4dff-9de1-3cf8bcd0c19e" alt=""><figcaption></figcaption></figure>

**3. CRM sync with AI field mapping.** If you've connected a CRM integration, form responses sync automatically. [HubSpot](https://docs.supademo.com/workspace-settings/integrations/hubspot) and [Salesforce](https://docs.supademo.com/workspace-settings/integrations/salesforce) sync uses AI field mapping: whether you've named a field "Company", "Corporation", or "Business Name", Supademo auto-detects and syncs it to the appropriate CRM field with no manual mapping. Marketo, Zoho, and Pipedrive integrations are also available.

**4. Personalizing demo content with dynamic variables.** Form responses can drive [dynamic variables](https://docs.supademo.com/customize/personalize/variables-and-tokens.md), so titles, hotspot text, chapters, and HTML content in your Supademo update based on what the viewer entered. This tutorial shows the setup:

{% @supademo/embed url="<https://app.supademo.com/demo/cm9is2abs2vi3ljv5lfpmn8kn>" demoId="cm9is2abs2vi3ljv5lfpmn8kn" %}

## FAQ

### How do I add a lead form to my demo?

Add a Chapter anywhere in your Supademo, choose the **Form** option, add up to 7 fields, and click Save. The form goes live immediately on your published demo, with no embed code or third-party form builder. Place it after a few value-showing steps if you want higher completion, or on the first step to gate the entire demo.

### Which field types can a form have?

Nine: Text input, Email, Phone, Textarea, Dropdown, Checkbox, Multi-select, Date, and Number. A form holds up to 7 fields, and each one can be required or optional.

### Can I require business email addresses?

Yes. Turn on the **Business Emails Only** toggle in the form's access controls to reject personal addresses. For finer control, use the whitelist to allow only specific domains or the blacklist to block specific ones. Both accept comma-separated lists scaling to hundreds of domains. Submitted addresses are also checked with external email verification.

### Do form responses sync to HubSpot or Salesforce?

Yes. With a HubSpot or Salesforce integration connected, responses sync automatically, and AI field mapping matches your form fields to the right CRM properties even when the names don't match exactly. Marketo, Zoho, and Pipedrive integrations are also available. Responses are always emailed to you and stored in the Lead Data tab of your analytics as well.
