Build
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.
- 01SourceYour website posts the answers to its own endpoint.
- 02FormNames the fields, their types, options and rules.
- 03FlowChecks, routes and delivers every submission.
- 04DestinationEmail, Slack, Teams, Discord or a webhook.
Create a form
On the Forms page, choose New form. The dialog offers two ways to start, plus where the form will live.
- 01
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. - 02
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. - 03
Say where it will live
Pick the platform (Webflow, WordPress, plain HTML and so on) or Decide later. If you type the website, such asyourcompany.com, it becomes the form's only allowed website, so browsers can post only from that site and its subdomains. - 04
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 for prompt tips and limits.
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. |
| Settings | Name and description, accepting submissions, the success message and redirect, spam protection, the rate limit, learning new fields and retention. |
| Embed | The look of the form for hosted forms and the embed script: theme, accent color, corners and button text. |
The header above the tabs has an Accepting switch to pause the form, 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. |
| 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.
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. | 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. | 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 |
| Enterprise | 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.
| 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. |
Embed
The Embed tab sets the style hosted forms will use: a light or dark theme, an accent color, the corners (none, small, medium or large) and the button text, with a live preview on a sample page. The button text is also used by the HTML snippet in the Connect tab. Hosted forms and the copy and paste embed script are coming next. Until then, connect your own form to an endpoint.
Example: a quote request
A design studio wants quote requests from its website, with the budget for routing and an optional brief.
- 01
Start from the Quote request template
Choose New form, Start from a template, then Quote request. Pick Webflow and typestudio.com. The form gets six fields: name, email, company, service, budget, details. - 02
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 tobrief, turn on Allow several files and type.pdf,.docxunder accepted file types. - 03
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. - 04
Set what happens after sending
In Settings, set Redirect to tohttps://studio.com/thanks. Allowed websites already listsstudio.com. - 05
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. - 06
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.
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:
<form action="https://formpik.modulify.website/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.modulify.website/formpik.js" defer></script>The JavaScript version sends JSON, which cannot carry files, so it leaves the brief out.