## Fields (Add a field)

- **Short Text**: a one-line answer, like a name. Tick **Must be a web address** to accept only links. Visitors can type example.com/review and it's saved as https://example.com/review.
- **Paragraph**: a longer answer.
- **Email**: an email address. Tick **Require confirmation** to make visitors type it twice. The two must match, and only one copy is saved.
- **Number** and **Date**: a number, or a date from a date picker.
- **Dropdown**: pick one choice from a list.
- **Single Choice (Radio)**: pick one choice, with all choices shown.
- **Multi-select Dropdown**: pick several choices from a list. Good for long lists like genres.
- **Multiple Choice (Checkboxes)**: tick any number of choices.
- **Star Rating**: one to five stars.
- **File Upload**: attach a file of up to 50 MB.
- **Mailing List Signup**: a tick box that adds the visitor to one of your mailing lists (see below).
- **Hidden field (fixed value)**: visitors don't see it. Every response sends the value you type, which is handy for telling apart two copies of a form.

New choice fields start with Option 1 and Option 2. Replace them with your own choices, one per line.

## Settings on each field

- **Question label**: what visitors see.
- **Internal name**: optional. If you fill it in, you see it instead of the label in Submissions, the CSV export and field mapping.
- **Placeholder**: grey example text inside the box. Not available for choice, star rating or file fields.
- **Required**: the form can't be sent without it.
- **Width**: **Full width**, **Half (2 per row)**, **Third (3 per row)** or **Quarter (4 per row)**. Narrow fields that sit next to each other in your list share a row on the live form. A full-width field or any block starts a new row.

If your form has an email question, visitors also get a **Send me a copy of my submission** tick box. The first visible Email question is the one used for copies, duplicate checks and mailing list sign-ups.

## Blocks (Add a block)

- **Header**: a heading to break up the form.
- **Rich Text**: formatted text with a toolbar.
- **HTML Block**: your own HTML. On the live form only basic formatting is kept: paragraphs, headings, bold, italic, underline, lists, links, images, quotes and dividers. Scripts, embeds and anything else are removed, and links open in a new tab.
- **Image**: upload a JPEG, PNG, WebP or GIF of up to 10 MB, or reuse one you've uploaded before. Add alt text and choose the size and alignment.
- **Book Info**: shows a book from your Book Library.
- **Group**: starts a titled section.

## Adding people to your mailing list

The **Mailing List Signup** field shows an unticked box with your own wording. Only visitors who tick it are added.

1. Connect your list in **Newsletter Analytics** first.
2. Make sure the form has an **Email** question. That's the address that gets added.
3. Add a **Mailing List Signup** field and edit the words next to the box.
4. Pick your list from **Choose a list…** and add a tag if you want one.
5. Click **Save list connection**, then **Test with my email**. The test adds your own address to the list with the tag Form Builder test.
6. Optionally choose which question to use under **Send as the subscriber's name**. **Automatic** uses a Short Text question labelled like a name, or the first Short Text question.
7. Save the form.

Your list's API key must be allowed to add subscribers, not just read them. If you change the key, click **Re-save list connection**. On the **Submissions** tab, an icon in the column shows whether each person was added, couldn't be added, or didn't tick the box.