# Forms

A form is the list of fields a submission carries: their keys, types, options and rules. Your website posts answers to it, and flows read those answers to decide where each submission goes.

**On this page you will learn**

- Create a form from a template or from a sentence with AI
- What each of the four tabs is for
- Every field setting, and how to edit several fields at once
- Spam, redirect, rate limit and retention settings with their defaults
- What happens when your website posts, and where the rules are enforced
- A worked example: a quote request form from start to finish

## Where forms fit

A form sits between the websites that send submissions and the flows that process them. One form can have several sources, for example your main site and a landing page, and several flows. The form itself never sends anything: it describes the answers, and the flows act on them.

1. **Source**: Your website posts the answers to its own endpoint.
2. **Form**: Names the fields, their types, options and rules.
3. **Flow**: Checks, routes and delivers every submission.
4. **Destination**: Email, Slack, Teams, Discord or a webhook.

Every submission is stored in the inbox, whatever the flows do with it.

## Create a form

On the Forms page, choose **New form**. The dialog offers two ways to start, plus where the form will live.

1. **Pick how to start**

   **Describe it with AI** drafts the fields from a sentence. **Start from a template** gives you a ready-made set of fields. You can change everything afterwards either way.
2. **Name it**

   With a template, the name defaults to the template name. With AI, leave the name empty and AI names the form for you.
3. **Say where it will live**

   Pick the platform (Webflow, WordPress, plain HTML and so on) or **Decide later**. If you type the website, such as `yourcompany.com`, it becomes the form's only allowed website, so browsers can post only from that site and its subdomains.
4. **Create it**

   The form opens on its Fields tab. It accepts submissions straight away, and when you chose a platform its endpoint is waiting in the Connect tab.

### Templates

| Template | What it asks | Fields |
| --- | --- | --- |
| Contact form | Name, email, a topic dropdown and a message. | full_name, email, topic, message |
| Quote request | Qualify leads by service, budget and timeline. | name, email, company, service, budget, details |
| Support request | Collect tickets with a priority and a product. | email, priority, subject, description, screenshot |
| Newsletter signup | An email address, a first name and consent. | email, first_name, consent |
| Job application | Role, links and a resume upload. | full_name, email, role, portfolio, resume |
| Customer feedback | Star rating, an NPS score and what to improve. | rating, recommend_score, liked, improve, email |
| Booking request | A date and time, a service and contact details. | full_name, email, phone, service, appointment, first_visit, notes |
| Event registration | Attendees, sessions, country and consent. | full_name, email, company, country, sessions, consent |
| Blank form | Start from scratch and add your own fields. | None |

### Describe it with AI

Write who fills the form in, the questions you need answered and anything you route on, like a topic or a budget. AI drafts the name, a one sentence description and the fields, then the form opens with them. Drafts count toward your plan's daily AI drafts. See [AI features](https://formpik.com/docs/ai) for prompt tips and limits.

> **At the plan limit**
>
> When the workspace already has every form its plan allows, the dialog shows the limit and an upgrade link instead of the form. Nothing you already have is changed.

## The four tabs

| Tab | What you do there |
| --- | --- |
| Fields | Build the form: the list of fields, a live preview you can submit, and the settings of the selected field. |
| Connect | Add sources, copy each endpoint and the snippet for its platform. See [Connect a website](https://formpik.com/docs/sources). |
| Settings | Name and description, accepting submissions, the success message and redirect, spam protection, the rate limit, learning new fields and retention. |
| Share | Publish the form on its own share link, copy the embed code for any website, and set its look: theme, accent color, corners and button text. See [Share and embed](https://formpik.com/docs/share). |

The header above the tabs has an **Accepting** switch to pause the form, a **Publish** or **Share** button that opens the Share tab, a **Submissions** button that opens the inbox filtered to this form, **Build a flow**, and a menu with **Duplicate form** and **Delete form**.

## The Fields tab

The tab has three parts. On the left is the field list, in the order visitors see it, with arrows to move a field up or down. In the middle is a live preview of the form. On the right are the settings of the selected field. Click a field in the list or in the preview to select it.

- **Fill sample answers** fills the preview with realistic answers for every field.
- **Clear** empties the preview again.
- **Submit the preview** to check the answers against the form's rules. Problems show under each field. When everything passes, Formpik saves a test submission and runs every live flow of this form as a test, so nothing is actually sent. A Test result panel then shows each flow's steps, with a link to the submission in the inbox.

### Field settings

| Setting | What it does |
| --- | --- |
| Type | One of 26 types, grouped as Basics, Date and time, Choices, Ratings and scales, Advanced, Layout. Changing the type keeps the rules when they mean the same thing (short text, long text and address; number and amount; multiple choice and multi-select) and resets them otherwise. See [Field types](https://formpik.com/docs/field-types). |
| Label | The question visitors read. Consent fields call it the agreement text, text blocks call it the text. |
| Key | The input name your website sends, such as `email`. Lowercase letters, numbers and underscores, starting with a letter, and unique in the form. Spaces you type become underscores. |
| Required | The answer must be there for the form rules to pass. Hidden fields and layout blocks have no Required switch, and consent fields call it Must be ticked. |
| Options | Dropdowns, multi-select, single and multiple choice: the label visitors see and the value that is sent. |
| Placeholder | Hint text inside the box. Dropdowns and country fields call it the empty choice text. |
| Help text | A line under the field. Headings call it subtext. |
| Validation | Depends on the type: minimum and maximum characters, a pattern, a number range, or how many options can be picked. |
| Type settings | Stars for a rating, the ends and labels of a scale, a slider range and step, a currency, several files and accepted file types, a hidden default value. |

When flows use the selected field, a note under the key names them, with a link to each. The two buttons at the top of the settings duplicate the field or delete it.

### Add fields

- **Add field** opens the field picker. Type to search all 26 types, then click one to add it right away.
- To add several types at once, tick the box next to each and choose **Add fields**. They are added together and stay selected.
- New fields go after the selected field, or at the end when nothing is selected. They start optional, with the type's starting settings and a key made from the label. The first email field gets the key email, which is what Reply to sender uses.
- **Add with AI**, above the preview, drafts new fields from a sentence. AI sees the labels you already have, skips them, and adds the new fields after your selection.

### Select several fields

Select more than one field to change them together:

| To select | Do this |
| --- | --- |
| One field | Click it in the list or the preview. |
| A range | Click the first field, then hold `Shift` and click the last one. |
| Fields one by one | Hold `Cmd` on a Mac or `Ctrl` on Windows and click each field, or tick the box that appears on it. |
| Every field | Tick the box in the list header. Tick it again to clear the selection. |

With several fields selected, the settings panel lists them and offers:

- **Required**: one switch makes every selected field required, or every one optional. It shows how many are required now.
- **Duplicate all**: copies them, with fresh keys such as `email_2`.
- **Delete all**: removes them after a confirmation.

Pick a single field again to change its label, key, options and rules.

> **Renaming keeps flows working**
>
> When you rename a key or the value of an option, every flow of this form is rewritten to use the new name: routes, conditions, checks and every template. Older submissions keep the answers they were sent with, and your website has to send the new names from then on.

> **Deleting fields**
>
> Deleted fields disappear from the form and from new submissions. Older submissions keep their answers. Flows that still use a deleted field show a problem that you have to fix before they can go live again.

## Settings

| Setting | What it does | New forms |
| --- | --- | --- |
| Accept submissions | When it is off, every source of the form answers 403 and nothing is stored. The Accepting switch in the header does the same. | On |
| After a successful send | **Show a message** keeps visitors on the page. **Go to a page** sends them to your own page. See [After someone sends a form](https://formpik.com/docs/sources#after). | Show a message |
| Success message | Shown by the Formpik script, on the thank you page of forms without it, and while visitors wait to go on to a page. It is returned to JavaScript requests too. | Thanks, we've received your submission. |
| Page to go to | Your thank you page. Answers in double curly braces after the website address, like `?name={{name}}`, are filled in for each visitor, and `{{submission.id}}` adds the submission id. | Empty |
| Pages by answer | Up to 10 rules that send matching visitors to their own page, such as big budgets to a booking page. The first rule that matches wins, and everyone else gets the choice above. | None |
| Before going to a page | Go right away, or show the success message for 3 or 5 seconds first. | Right away |
| Error message | Shown when a submission is refused. Leave it empty to show the exact reason, such as a paused form or too many tries. | Empty |
| Refuse answers that break the field rules | A submission whose answers break a field rule is refused with a 422 that names every field and what to fix, and nothing is stored. Off keeps it and notes the broken rules on it. See [Field rules](https://formpik.com/docs/field-types#rules). | On |
| Allowed websites | When you list any, browsers can post only from those sites and their subdomains, and others get a 403. Requests with an API key skip this check. Empty allows every website. | The website you typed, or empty |
| Spam trap field | A hidden `_gotcha` input that people never see. Bots fill it in, and those submissions are stored as spam with no flows run. | On |
| Bot check | Off, Cloudflare Turnstile or Google reCAPTCHA. Add the widget to your form. A missing or failed check stores the submission as spam and runs no flows. | Off |
| Limit per visitor | Submissions per hour from the same address, from 1 to 1,000. More are refused with a 429. | 30 |
| Learn new fields automatically | Answers with a key the form does not know yet are added as new fields, instead of only being stored. | On |
| Keep submissions for | How long submissions and their files are kept. Older ones are deleted automatically. | The longest your plan allows, up to 1 year |

The **Danger zone** at the bottom deletes the form. Its sources stop accepting submissions, its stored submissions are deleted, and flows that use it are paused.

### Learning new fields

With **Learn new fields automatically** on, you can connect a website before you build a single field. For every key the form does not know, Formpik adds an optional field labeled after the key (`company_size` becomes "Company size") and picks a type from the value:

- An email address becomes Email, a plain number becomes Number, and a link starting with http:// or https:// becomes Website.
- Text longer than 80 characters, or with line breaks, becomes Long text. Anything else becomes Short text.
- An uploaded file becomes File upload.

Keys that already follow the key rules are learned, other keys and keys starting with an underscore are only stored. Spam never teaches the form anything, and one submission adds at most 50 fields.

### Retention

The choices in **Keep submissions for** depend on the plan. A longer setting saved earlier is lowered to the plan's longest choice.

| Plan | Choices |
| --- | --- |
| Starter | 30 days |
| Pro | 30 days, 90 days, 1 year |
| Max | 30 days, 90 days, 1 year, Forever |

## When your website posts

Each source has its own endpoint. Your website sends the answers named by their keys, as JSON, a regular form post or a multipart upload with files. Formpik answers first and runs the flows right after. The full reference is in [Send a submission](https://formpik.com/docs/api/submit).

| Request | What happens |
| --- | --- |
| JavaScript (fetch, JSON) | A JSON answer with the submission id and your success message. |
| Plain HTML form | A redirect to the `_redirect` field of the post, else the form's Redirect to address, else the page it came from with `?submitted=1`. With none of these, a thank you page with your success message. |
| Form paused, or website not allowed | 403, nothing stored. |
| Too many from one address, or the monthly submissions of your plan used up | 429, nothing stored. |
| Spam trap filled, or bot check failed | Stored under Spam with the reason, and no flows run. |

> **The endpoint stores what it receives**
>
> Required answers, formats, options and lengths are checked in the preview and by a **Validate** step with **Use the form's rules** on. The endpoint itself stores every submission that gets through the spam and rate checks. Start every flow with a Validate step, as every flow template except Blank flow does, so incomplete submissions go down its Failed path instead of reaching your team.

## Share and embed

The Share tab publishes the form on a page of its own, with a link you can send to anyone, and gives you the code to embed it on any website, inline or as a popup. It also sets the style the page and embeds use: a light or dark theme, an accent color, the corners (none, small, medium or large) and the button text, with a live preview. The button text is also used by the HTML snippet in the Connect tab. See [Share and embed](https://formpik.com/docs/share).

## Example: a quote request

A design studio wants quote requests from its website, with the budget for routing and an optional brief.

1. **Start from the Quote request template**

   Choose **New form**, **Start from a template**, then **Quote request**. Pick Webflow and type `studio.com`. The form gets six fields: name, email, company, service, budget, details.
2. **Add a brief upload**

   Select **Project details**, choose **Add field** and pick **File upload**. It lands right after. Change the label to "Project brief", the key to `brief`, turn on **Allow several files** and type `.pdf,.docx` under accepted file types.
3. **Check the required answers**

   Click **Your name**, hold `Cmd` or `Ctrl` and click **Email** and **Budget**. The panel shows "All 3 are required", and one switch would make all three optional again.
4. **Set what happens after sending**

   In Settings, set **Redirect to** to `https://studio.com/thanks`. Allowed websites already lists `studio.com`.
5. **Test it**

   Back on Fields, choose **Fill sample answers** and submit the preview. Without flows the test submission is only stored, which the Test result panel tells you.
6. **Connect and route**

   Copy the snippet from the Connect tab into your site, then choose **Build a flow** and pick the Route by answer template. It routes on the first single choice field, What do you need?, so switch **Route by** to Budget to send each budget to the right person. See [Flows](https://formpik.com/docs/flows).

For an HTML platform like Webflow, the Connect tab generates the HTML version of this snippet, and a JavaScript source gets the JavaScript one. The input names are the keys, and the file field makes the HTML form a multipart upload:

*HTML*

```html
<form action="https://formpik.com/api/in/YOUR_SOURCE_KEY" method="POST" enctype="multipart/form-data">
  <label for="name">Your name</label>
  <input id="name" name="name" type="text" required>
  <label for="email">Email</label>
  <input id="email" name="email" type="email" required>
  <label for="company">Company</label>
  <input id="company" name="company" type="text">
  <fieldset>
    <legend>What do you need?</legend>
    <label><input type="radio" name="service" value="website"> Website</label>
    <label><input type="radio" name="service" value="brand"> Brand identity</label>
    <label><input type="radio" name="service" value="product"> Product design</label>
    <label><input type="radio" name="service" value="unsure"> Not sure yet</label>
  </fieldset>
  <label for="budget">Budget</label>
  <select id="budget" name="budget" required>
    <option value="">Choose one</option>
    <option value="under_10k">Under $10k</option>
    <option value="10k_25k">$10k to $25k</option>
    <option value="25k_50k">$25k to $50k</option>
    <option value="50k_plus">$50k or more</option>
  </select>
  <label for="details">Project details</label>
  <textarea id="details" name="details" rows="4" required></textarea>
  <label for="brief">Project brief</label>
  <input id="brief" name="brief[]" type="file" multiple accept=".pdf,.docx">

  <!-- Spam trap: keep it hidden and empty -->
  <input type="text" name="_gotcha" tabindex="-1" autocomplete="off" style="display:none">

  <button type="submit" data-wait="Sending...">Send</button>

  <!-- Shown after sending, by the Formpik script below -->
  <p data-formpik-success hidden>Thanks, we've received your submission.</p>
  <p data-formpik-error hidden></p>
</form>
<script src="https://formpik.com/formpik.js" defer></script>
```

*JavaScript*

```js
const response = await fetch("https://formpik.com/api/in/YOUR_SOURCE_KEY", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "name": "Jane Cooper",
    "email": "jane@example.com",
    "company": "Acme Inc",
    "service": "website",
    "budget": "under_10k",
    "details": "Hi, we would like to talk about a new website for our team. Could you share your availability next week?"
  })
})

if (!response.ok) {
  // Show your own error message here
}
```

The JavaScript version sends JSON, which cannot carry files, so it leaves the brief out.

## Common questions

### Do I have to build every field before I connect my website?

No. With Learn new fields automatically on, keys the form does not know are added as fields when the first submissions arrive. You can rename and retype them afterwards.

### Why did a submission without a required answer get through?

The endpoint stores every submission that passes the spam and rate checks. The form's rules are applied by a Validate step with **Use the form's rules** on, which sends incomplete submissions down its Failed or spam path.

### Can two fields share a key?

No. The key field shows "Another field already uses this key" and keeps the old key until you pick a free one.

### What happens when I pause a form?

Every source of the form answers 403 and nothing is stored. Flows stay as they are and run again for new submissions once you turn the form back on.

### How do I copy a form?

Open the menu next to **Build a flow** and choose **Duplicate form**.

## Next steps

- [Field types](https://formpik.com/docs/field-types): What each type shows, sends and checks.
- [Share and embed](https://formpik.com/docs/share): Publish the form on its own link or embed it anywhere.
- [Connect a website](https://formpik.com/docs/sources): Point Webflow, WordPress or your own HTML at the form.
- [Flows](https://formpik.com/docs/flows): Check, route and deliver every submission.
- [Spam, privacy and security](https://formpik.com/docs/security): Spam trap, bot checks, allowed websites and retention.

---

Source: https://formpik.com/docs/forms
