# Form blocks

> Form blocks in the editor: Form, lead form, newsletter signup and fields. Every setting, where submissions go, and how to test a form.

Source: https://docs.personacart.com/editor/blocks/forms

In short: {"Form blocks in the editor: Form, lead form, newsletter signup and fields. Every setting, where submissions go, and how to test a form."}

Form blocks collect information from visitors: an email for your newsletter, a contact message, a waitlist place, a lead magnet download. What people send flows into your [Leads](/growth/leads) and customer records, so you can follow up.

1. Open a page in the editor, hover inside a section and press **Add**.
2. Choose **Component**, then **Form** or **Newsletter**.
3. Set the fields in the inspector, then test it in **Preview** before you publish.

## Where to find it

Open a page in the editor (Sidebar → STOREFRONT → Pages), then:

- Press **Add**, then **Component**, and open the **Forms and contact** shelf (it holds **Newsletter** and **Form**) or search "form" or "newsletter".
- For whole sections, the **Newsletter & Forms** and **FAQ & Contact** filter chips in the **Section** picker list ready-made sign-up and contact sections.
- See [Add a section or a block](/editor/add-section-and-templates).

## The blocks

The editor has two form blocks: a newer one for new pages and the original **Form**. The Layers panel names both "Form". The Add picker lists the original under the **Forms and contact** shelf. See the next sections.

## Form, newer (for new pages)

- One block for email capture and contact forms.
- Visitors get visible labels marked (required) or (optional), checks as they leave a box, a summary of any errors, and clear sending, success and error states.
- It posts to your sign-up list (signup, waitlist, lead magnet) or to a contact inquiry, so there is no endpoint to type.

| Setting | What it does |
| --- | --- |
| **Form → Button text** | The label on the send button. |
| **Line under the button** | A short line of small print under the button. |
| **Consent checkbox text** | Text for a consent tick box. Leave empty for no checkbox. |
| **Fields** | **New field** adds one. Each has **Label**, **Kind of field** (**Text**, **Email**, **Phone**, **Choice list**, **Long text**), **Required**, **Example text inside**, **Hint under the field**, and **Choices, one per line** for a choice list. Move up, move down, duplicate and delete are on each field. |
| **After sending** | **Heading** and **Message** shown after a successful send (use the token shown to include the address typed). **Download link** and **Download button text** give visitors a file or page right after they send. |
| **Sign-up** | **Ask them to confirm by email first** (double opt-in): "They join your list only after they click the link in the email we send. Until then they are not mailed." **Places** limits how many people can join; the page shows how many are left (empty means no limit). **File to send** emails each person their own private link that expires (**Choose a file**, **Change file**, **Remove**). |

## Form (original block)

The original **Form** block lets you build any set of fields.

| Setting | What it does |
| --- | --- |
| **Title** and **Description** | Optional heading and intro. |
| **Fields** | Per field: **Label**, **Kind of answer** (**Short text**, **Email**, **Phone**, **Long text**, **Dropdown**, **Tick box**, **Pick one**), **Hint inside the box**, **Must be filled**, **Choices**, **Fewest characters**, **Width in the form** (**Beside others** or **Own row**), **Phone autofill** (Full name, Email, Phone number, Company, Street address, City, Postcode, Country, or **Do not autofill**). Two short boxes can sit side by side on wide screens (**Two boxes in a row**); on a phone every box has its own row. |
| **Text style of every label** and **helper** | One style applied to all labels and all helper texts. |
| **Button and thank-you** | **Button text**, **Message after sending** (default "Thanks! We got your message."), and a **Redirect URL**: after a successful send, take the visitor to a page instead. |
| **Where it goes** | "Every send is saved as a lead in your Leads list." with **Open Leads** and **Change who gets the email**. A custom address typed under **Advanced** sends answers there instead of your Leads list. |
| **Label these leads as** | A tag put on each lead (for example `summer-camp`) so you can find them. |
| **When something goes wrong** | Your own words for **Answer missing**, **Email looks wrong**, **Phone looks wrong**, **Answer too short**, **Consent box not ticked**, **Could not send**, **List is full** and **Check your email**. A box left empty keeps the standard words shown in grey. |
| **Check what would be sent** | A dry run: shows the answers a visitor's send would carry, and where a real send would go. Nothing is sent and no lead is created. |
| **Preview thank-you** | Shows what visitors read after they send. Nothing is sent. |

Each field's **answer name** must be filled, not reserved and not repeated; the editor shows "Fix it" when it is not, because the live form would not send otherwise.

## Newsletter

- An email sign-up block: **Title**, **Subtitle**, **Email placeholder**, **Submit button text**, **Success message**, **Layout** and **Align**.
- **+ Add GDPR consent checkbox** adds a consent box whose text you can edit (**Remove** takes it away).
- Typography for the title, subtitle and button have their own settings.
- The editor preview says "Preview only — nothing was submitted. Real visitors will be subscribed." Sign-ups can feed your [campaigns](/growth/campaigns).

## Steps: add a contact form

  Press Add where the form belongs, choose Section, and pick a contact or Newsletter & Forms design, or choose Component and add a Form.
  Change the Title, add or remove Fields, and set which are Must be filled.
  Type the Button text and the Message after sending.
  Press Check what would be sent to preview the answers. Nothing is sent.
  Publish. Real sends appear in Growth → Leads.

## What happens, and what doesn't

- Submissions become **leads and contacts**, not just an email. A newsletter sign-up feeds your sign-up list and can start follow-up.
- Fields get their look from the theme's **Form fields** (**Field border**, **While typing**), so they match your store. See [Buttons, photos and page defaults](/editor/theme/components).
- A form field with no answer name is flagged in the editor and would not send on the live page.

## Questions
