Build
Field types
Formpik has 26 field types in 6 groups. The type decides what visitors see, which value your website sends, how the answer is checked and how it reads in emails and messages.
On this page you will learn
- What every type looks like and what it sends
- The HTML input each type needs, generated the way the Connect tab does it
- Type settings: stars, scale ends, slider range, currency, files, choice limits
- The checks the form rules run, with the messages visitors read
- How lists, option values and country codes are sent
- How each answer reads in emails, chat messages and the inbox
All types at a glance
| Field | Type in the API | Group | What your website sends |
|---|---|---|---|
| Short text | text | Basics | Text |
| Long text | textarea | Basics | Text, line breaks kept |
email | Basics | An email address | |
| Phone | phone | Basics | 7 to 15 digits, with spaces, dashes or a leading + |
| Number | number | Basics | A number, such as 12 or 4.5 |
| Amount | currency | Basics | A number, such as 2500 or 99.90, in the currency you pick |
| Website | url | Basics | A web address, with or without https:// |
| Address | address | Basics | Text, line breaks kept |
| Date | date | Date and time | YYYY-MM-DD, such as 2026-12-01 |
| Time | time | Date and time | HH:MM in 24 hours, such as 14:30 |
| Date and time | datetime | Date and time | YYYY-MM-DDTHH:MM, such as 2026-12-01T14:30 |
| Dropdown | select | Choices | The value of one option |
| Multi-select | multiselect | Choices | A list of option values, as name[] in HTML or an array in JSON |
| Single choice | radio | Choices | The value of one option |
| Multiple choice | checkbox | Choices | A list of option values, as name[] in HTML or an array in JSON |
| Yes or no | yesno | Choices | yes or no |
| Country | country | Choices | A two letter country code, such as US or DE |
| Rating | rating | Ratings and scales | A whole number from 1 to the number of stars |
| Opinion scale | scale | Ratings and scales | A whole number between the two ends of the scale |
| Slider | slider | Ratings and scales | A number between the minimum and maximum |
| Consent | consent | Advanced | yes when ticked, nothing when not |
| File upload | file | Advanced | A file in a multipart upload, up to 10 MB each |
| Hidden | hidden | Advanced | Text your page fills in |
| Heading | heading | Layout | Nothing, it only shows text |
| Text block | paragraph | Layout | Nothing, it only shows text |
| Divider | divider | Layout | Nothing, it only draws a line |
How answers read
Formpik stores exactly what your website sent and shows it in a readable way in emails, chat messages, the inbox and templates. This table is produced from a sample answer of every type:
| Field | Sent | Reads as |
|---|---|---|
| Short text | Jane Cooper | Jane Cooper |
| Long text | Hi, we would like to talk about a new website for our team. Could you share your availability next week? | Hi, we would like to talk about a new website for our team. Could you share your availability next week? |
jane@example.com | jane@example.com | |
| Phone | +1 415 555 0132 | +1 415 555 0132 |
| Number | 1 | 1 |
| Amount | 2500 | 2500 EUR |
| Website | https://example.com | https://example.com |
| Address | 1 Market Street
San Francisco, CA 94105 | 1 Market Street San Francisco, CA 94105 |
| Date | 2026-12-01 | 2026-12-01 |
| Time | 14:30 | 14:30 |
| Date and time | 2026-12-01T14:30 | 2026-12-01 14:30 |
| Dropdown | sales | Sales |
| Multi-select | ["speed","quality"] | Speed, Quality |
| Single choice | website | Website |
| Multiple choice | ["keynote"] | Morning keynote |
| Yes or no | yes | Yes |
| Country | US | United States |
| Rating | 4 | 4 of 5 |
| Opinion scale | 9 | 9 of 10 |
| Slider | 50 | 50 |
| Consent | yes | Yes |
| File upload | ["brief.pdf","moodboard.png"] | brief.pdf, moodboard.png |
| Hidden | spring-campaign | spring-campaign |
Use {{key.value}} in a template when you need the stored value of a choice field instead of its label. See Variables and templates.
Basics
Free answers typed into a box. Most forms are built from these.
Short text
Names, titles and other one-line answers. Type text.
- Visitors see: A one-line text box.
- Sends: Text.
- Checks: Minimum and maximum characters ("Use at least 10 characters"), and an optional pattern, a regular expression such as
^[A-Z]{2}[0-9]+$, with your own error message. - Settings: Placeholder, help text, min and max characters, pattern and its error message.
<label for="full_name">Full name</label>
<input id="full_name" name="full_name" type="text" required>Long text
Messages and detailed answers. Type textarea.
- Visitors see: A box of several lines. Line breaks are kept.
- Sends: Text, line breaks kept.
- Checks: Minimum and maximum characters.
- Settings: Placeholder, help text, min and max characters.
<label for="message">Message</label>
<textarea id="message" name="message" rows="4" minlength="10" maxlength="2000" required></textarea>Checked for a valid address. Type email.
- Visitors see: An email box, with the email keyboard on phones.
- Sends: An email address.
- Checks: A valid address, otherwise "Enter a valid email address".
- Settings: Placeholder and help text.
<label for="email">Email</label>
<input id="email" name="email" type="email" required>Phone
Phone numbers in any format. Type phone.
- Visitors see: A phone box, with the number pad on phones.
- Sends: 7 to 15 digits, with spaces, dashes or a leading +.
- Checks: Digits, spaces, brackets, dots, dashes and a leading +, with 7 to 15 digits. Otherwise "Enter a valid phone number".
- Settings: Placeholder and help text.
<label for="phone">Phone</label>
<input id="phone" name="phone" type="tel">Number
Quantities, ages and other numbers. Type number.
- Visitors see: A number box.
- Sends: A number, such as 12 or 4.5.
- Checks: A number (spaces and commas are ignored) inside your range: "Enter 1 or more", "Enter 20 or less".
- Settings: Placeholder, help text, minimum and maximum.
<label for="guests">Number of guests</label>
<input id="guests" name="guests" type="number" min="1" max="20">Amount
Budgets and prices with a currency. Type currency.
- Visitors see: A number box with the currency code next to it, in steps of 0.01.
- Sends: A number, such as 2500 or 99.90, in the currency you pick.
- Checks: An amount inside your range, otherwise "Enter an amount, such as 2500". New amount fields start with a minimum of 0.
- Settings: Currency (one of 18 codes, such as USD, EUR, GBP), placeholder, help text, minimum and maximum. The currency is not sent: the answer is the number.
<label for="budget">Budget (EUR)</label>
<input id="budget" name="budget" type="number" step="0.01" min="0">Website
Links and web addresses. Type url.
- Visitors see: A web address box.
- Sends: A web address, with or without https://.
- Checks: An address without spaces whose host has a dot, with or without
https://. Otherwise "Enter a valid web address". - Settings: Placeholder and help text.
<label for="website">Website</label>
<input id="website" name="website" type="url">Address
Street, city and postcode in one box. Type address.
- Visitors see: A box of three lines, filled in by the browser when visitors allow it.
- Sends: Text, line breaks kept.
- Checks: Minimum and maximum characters.
- Settings: Placeholder, help text, min and max characters.
<label for="address">Delivery address</label>
<textarea id="address" name="address" rows="3" autocomplete="street-address"></textarea>Date and time
Native date and time pickers. Answers are sent in a fixed format, whatever the visitor's language.
Date
A calendar date. Type date.
- Visitors see: The browser's date picker.
- Sends: YYYY-MM-DD, such as 2026-12-01.
- Checks: A real date as
YYYY-MM-DD, otherwise "Enter a valid date". - Settings: Help text.
<label for="start_date">Start date</label>
<input id="start_date" name="start_date" type="date">Time
A time of day. Type time.
- Visitors see: The browser's time picker.
- Sends: HH:MM in 24 hours, such as 14:30.
- Checks:
HH:MMin 24 hours, seconds optional. Otherwise "Enter a valid time, such as 14:30". - Settings: Help text.
<label for="preferred_time">Preferred time</label>
<input id="preferred_time" name="preferred_time" type="time">Date and time
A date with a time, for bookings. Type datetime.
- Visitors see: One picker for a date and a time.
- Sends: YYYY-MM-DDTHH:MM, such as 2026-12-01T14:30.
- Checks:
YYYY-MM-DDTHH:MM, otherwise "Enter a valid date and time". Emails show it with a space instead of the T. - Settings: Help text.
<label for="appointment">Appointment</label>
<input id="appointment" name="appointment" type="datetime-local" required>Choices
Answers picked from a list. Formpik stores the value of an option and shows its label, and these are the fields flows route on best.
Dropdown
Pick one option from a list, great for routing. Type select.
- Visitors see: A dropdown that starts on the empty choice text, "Choose one" unless you change it.
- Sends: The value of one option.
- Checks: One of the option values, otherwise "Choose one of the listed options".
- Settings: Options, empty choice text, help text.
<label for="topic">What can we help with?</label>
<select id="topic" name="topic" required>
<option value="">Choose one</option>
<option value="sales">Sales</option>
<option value="support">Support</option>
<option value="partnerships">Partnerships</option>
<option value="other">Something else</option>
</select>Multi-select
Pick several options from a compact list of tags. Type multiselect.
- Visitors see: A compact row of tags. Visitors click each tag to pick it or drop it.
- Sends: A list of option values.
- Checks: Every value is one of the options ("Choose from the listed options"), and the number picked is inside your limits ("Choose at least 2 options", "Choose at most 3 options").
- Settings: Options, at least and at most, help text.
<label for="liked">What did you like?</label>
<select id="liked" name="liked[]" multiple>
<option value="speed">Speed</option>
<option value="quality">Quality</option>
<option value="support">Support</option>
<option value="price">Price</option>
</select>Single choice
Pick one option, all visible. Type radio.
- Visitors see: Every option listed with a round button. Visitors pick one.
- Sends: The value of one option.
- Checks: One of the option values, otherwise "Choose one of the listed options".
- Settings: Options and help 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>
</fieldset>Multiple choice
Tick any number of options. Type checkbox.
- Visitors see: Every option listed with a tick box. Visitors tick any number.
- Sends: A list of option values.
- Checks: The same as multi-select: listed values only, within your at least and at most limits.
- Settings: Options, at least and at most, help text.
<fieldset>
<legend>Which sessions will you join?</legend>
<label><input type="checkbox" name="sessions[]" value="keynote"> Morning keynote</label>
<label><input type="checkbox" name="sessions[]" value="workshop"> Hands-on workshop</label>
<label><input type="checkbox" name="sessions[]" value="meetup"> Evening meetup</label>
</fieldset>Yes or no
Two buttons for a quick yes or no. Type yesno.
- Visitors see: Two buttons side by side.
- Sends: yes or no.
- Checks:
yesorno, otherwise "Choose one of the listed options". - Settings: The text of each button, such as "Ja" and "Nein". The values stay
yesandno.
<fieldset>
<legend>Are you an existing customer?</legend>
<label><input type="radio" name="existing_customer" value="yes"> Yes</label>
<label><input type="radio" name="existing_customer" value="no"> No</label>
</fieldset>Country
Every country in a searchable list. Type country.
- Visitors see: A dropdown of all 250 countries by name, filled in by the browser when visitors allow it.
- Sends: A two letter country code, such as US or DE.
- Checks: A known two letter code, otherwise "Choose a country from the list".
- Settings: Empty choice text and help text. The list itself is built in.
<label for="country">Country</label>
<select id="country" name="country" autocomplete="country" required>
<option value="">Choose a country</option>
<option value="AF">Afghanistan</option>
<option value="AX">Åland Islands</option>
<option value="AL">Albania</option>
<!-- and the other 247 countries -->
</select>Ratings and scales
Answers that are numbers on a range, so If / else can compare them with is greater than or is less than.
Rating
Stars, from 3 up to 10. Type rating.
- Visitors see: A row of stars. Clicking the chosen star again clears it.
- Sends: A whole number from 1 to the number of stars.
- Checks: A whole number from 1 to the number of stars, otherwise "Pick from 1 to 5 stars".
- Settings: Number of stars: 3 to 10, 5 for a new field.
<fieldset>
<legend>How would you rate us?</legend>
<label><input type="radio" name="rating" value="1"> 1</label>
<label><input type="radio" name="rating" value="2"> 2</label>
<label><input type="radio" name="rating" value="3"> 3</label>
<label><input type="radio" name="rating" value="4"> 4</label>
<label><input type="radio" name="rating" value="5"> 5</label>
</fieldset>Opinion scale
A row of numbers, like 0 to 10 for NPS. Type scale.
- Visitors see: A row of numbered buttons, with a word under each end when you set one.
- Sends: A whole number between the two ends of the scale.
- Checks: A whole number between the two ends, otherwise "Pick a number from 0 to 10".
- Settings: From 0 or 1, to any number from 3 to 10 (at least two above the start), and the words under the low and high end. A new scale runs from 0 to 10, an NPS question, with "Not likely" and "Very likely".
<fieldset>
<legend>How likely are you to recommend us?</legend>
<label><input type="radio" name="recommend_score" value="0"> 0</label>
<label><input type="radio" name="recommend_score" value="1"> 1</label>
<label><input type="radio" name="recommend_score" value="2"> 2</label>
<label><input type="radio" name="recommend_score" value="3"> 3</label>
<label><input type="radio" name="recommend_score" value="4"> 4</label>
<label><input type="radio" name="recommend_score" value="5"> 5</label>
<label><input type="radio" name="recommend_score" value="6"> 6</label>
<label><input type="radio" name="recommend_score" value="7"> 7</label>
<label><input type="radio" name="recommend_score" value="8"> 8</label>
<label><input type="radio" name="recommend_score" value="9"> 9</label>
<label><input type="radio" name="recommend_score" value="10"> 10</label>
</fieldset>Slider
Drag to pick a number in a range. Type slider.
- Visitors see: A slider with the chosen number shown next to it.
- Sends: A number between the minimum and maximum.
- Checks: A number between the minimum and maximum, otherwise "Pick a value", "Enter 0 or more" or "Enter 100 or less".
- Settings: Minimum, maximum and step: 0, 100 and 1 for a new slider. A maximum that is not above the minimum is treated as the minimum plus 100.
<label for="team_size">Team size</label>
<input id="team_size" name="team_size" type="range" min="0" max="100" step="5">Advanced
Agreements, uploads and values your page fills in.
Consent
A single checkbox to agree to terms. Type consent.
- Visitors see: One tick box with your agreement text.
- Sends: yes when ticked, nothing when not.
- Checks: With Must be ticked on, an unticked box fails with "Please accept to continue".
- Settings: Agreement text and Must be ticked.
<label><input type="checkbox" name="consent" value="yes" required> I agree to the privacy policy</label>File upload
Attachments like briefs or screenshots. Type file.
- Visitors see: A file picker, limited to the types you accept.
- Sends: A file in a multipart upload, up to 10 MB each.
- Checks: When required, "Please attach a file" or "Please attach at least one file". The endpoint takes up to 10 files of 10 MB each and 25 MB per submission.
- Settings: Allow several files and Accepted file types, such as
.pdf,.docxorimage/*. Empty accepts any file.
<label for="brief">Project brief</label>
<input id="brief" name="brief[]" type="file" multiple accept=".pdf,.docx">Hidden
Values your site fills in, like a campaign name. Type hidden.
- Visitors see: Nothing. The field is in the page but never shown.
- Sends: Text your page fills in.
- Checks: Never checked, and it cannot be required.
- Settings: Default value: the snippet puts it in the input, and your page can overwrite it, for example with a campaign name from the address.
<input type="hidden" name="campaign" value="spring-campaign">Layout
Blocks that organize long forms. They show text in the form but collect no answer.
Heading
A title that splits the form into sections. Type heading.
- Visitors see: A section title, with optional subtext under it.
- Sends: Nothing, it only shows text.
- Checks: Nothing, it collects no answer.
- Settings: Heading and subtext.
<h3>About you</h3>
<p>So we know who to reply to.</p>Text block
A few lines of explanation between fields. Type paragraph.
- Visitors see: A few lines of explanation between fields.
- Sends: Nothing, it only shows text.
- Checks: Nothing, it collects no answer.
- Settings: Text.
<p>Tell us a little about your project so we can send the right person.</p>Divider
A thin line between two parts of the form. Type divider.
- Visitors see: A thin line between two parts of the form.
- Sends: Nothing, it only draws a line.
- Checks: Nothing, it collects no answer.
- Settings: None.
<hr>Required answers
A required field with no answer fails the form rules with a message that fits the type:
| Fields | Message |
|---|---|
| Consent | Please accept to continue |
| File upload | Please attach a file, or Please attach at least one file when several are allowed |
| Multiple choice and multi-select | Choose at least one option |
| Rating, opinion scale and yes or no | Please pick an answer |
| Every other type | This field is required |
Field rules
Every field takes the rules that make sense for its type. Set them in the field's settings in the builder, or as validation on the field through the API, with the names below. The endpoint, the builder preview, the check-only address and your flows all read the same rules.
| Rule | API name | Field types | What it does |
|---|---|---|---|
| Fewest characters | min_length | Short text, Long text, Address, Email, Website | Answers shorter than this are refused. |
| Most characters | max_length | Short text, Long text, Address, Email, Website | Answers longer than this are refused. |
| Fewest words | min_words | Short text, Long text | For messages that need some detail. |
| Most words | max_words | Short text, Long text | Keeps answers short. |
| Pattern | pattern | Short text, Long text | A regular expression the whole answer must match, such as ^[A-Z]{2}[0-9]+$ for order numbers. |
| Pattern message | pattern_message | Short text, Long text | Shown when the answer does not match the pattern. |
| Most links | max_links | Short text, Long text | Links an answer may hold. 0 refuses every link, which stops most spam. |
| Blocked words | blocked_words | Short text, Long text | Answers holding any of these words or phrases are refused. |
| Lowest | min | Number, Amount, Slider, Opinion scale | Numbers and amounts: the lowest value. Sliders: the left end. Scales: 0 or 1. |
| Highest | max | Number, Amount, Slider, Rating, Opinion scale | Numbers and amounts: the highest value. Sliders: the right end. Ratings: the number of stars. Scales: the top. |
| Whole numbers only | integer | Number | Refuses 2.5 and other numbers with decimals. |
| Most decimals | max_decimals | Number, Amount | Digits allowed after the decimal point, such as 2 for cents. |
| Fewest choices | min_choices | Multiple choice, Multi-select | Options a visitor must pick. |
| Most choices | max_choices | Multiple choice, Multi-select | Options a visitor may pick. |
| Only these domains | allowed_domains | Email, Website | Email: only addresses at these domains. Web address: only links to these sites. Subdomains count too. |
| Never these domains | blocked_domains | Email, Website | Email addresses or links on these domains are refused. |
| Work emails only | block_free_email | Refuses free mailboxes such as gmail.com, outlook.com and yahoo.com. | |
| No throwaway emails | block_disposable | Refuses temporary mailboxes such as mailinator.com. | |
| Secure links only | require_https | Website | The address must start with https://. |
| International format | require_country_code | Phone | The number must start with + and a country calling code, such as +44 20 7946 0958. |
| Only these calling codes | phone_prefixes | Phone | Numbers must start with one of these, such as +1 or +44. Turns on the international format. |
| Countries | countries | Country | The two letter codes the list keeps or leaves out, depending on country_mode. Visitors only see the countries that are left. |
| Country mode | country_mode | Country | allow keeps only the listed countries, block offers every country except them. |
| Earliest date | min_date | Date, Date and time | As YYYY-MM-DD. |
| Latest date | max_date | Date, Date and time | As YYYY-MM-DD. |
| No past dates | no_past | Date, Date and time | Refuses days before today, in UTC. |
| No future dates | no_future | Date, Date and time | Refuses days after today, in UTC. For birthdays and past events. |
| Days of the week | weekdays | Date, Date and time | The days that can be picked, 0 for Sunday to 6 for Saturday. Leave out to allow every day. |
| Earliest time | min_time | Time, Date and time | As HH:MM, such as 09:00. |
| Latest time | max_time | Time, Date and time | As HH:MM, such as 17:30. |
| Largest file | max_file_size_mb | File upload | In MB, up to 10. |
| Most files | max_files | File upload | When several files are allowed, up to 10. |
| One per answer | unique | Short text, Email, Phone, Number, Website, Hidden | Refuses an answer another submission of this form already used, such as one signup per email. |
| Error message | message | Every field that collects an answer | Shown instead of the built-in message whenever the answer breaks a rule. |
- Work emails only refuses 40 free mailbox domains, such as gmail.com, googlemail.com, yahoo.com, yahoo.co.uk. No throwaway emails refuses 20 temporary mailbox domains.
- Country rules change the list itself: a visitor only ever sees the countries that are left, in the builder preview, the HTML snippet and the rules address.
- Dates are compared in UTC, so No past dates allows today wherever the visitor is.
- Blocked words and One per answer are checked only on the server and never shown to websites. One per answer looks at the submissions this form still keeps, leaving spam and test submissions out.
- A field's Error message replaces every built-in rule message for that field, but not the required message.
To show the messages on your own website, use the Formpik script or your own code. See Field errors on your website.
Fields that send several values
Multi-select and Multiple choice always send a list, and so does a file upload with Allow several files on. In an HTML form, add brackets to the name, such as sessions[], or repeat the same name. In JSON, send an array. Either way the answer is stored as a list.
<fieldset>
<legend>Which sessions will you join?</legend>
<label><input type="checkbox" name="sessions[]" value="keynote"> Morning keynote</label>
<label><input type="checkbox" name="sessions[]" value="workshop"> Hands-on workshop</label>
<label><input type="checkbox" name="sessions[]" value="meetup"> Evening meetup</label>
</fieldset>- Lists read as the labels joined with commas, such as "Morning keynote, Evening meetup".
- An If / else step matches a list when any of its values matches. For is not and doesn't contain, none of them may match.
- Route by answer looks at the first value of a list only, so use If / else to act on every value.
Options: labels and values
Every option has a label, the text visitors see, and a value, the text your website sends. Formpik stores the value, such as 50k_plus, and shows the label, such as "$50k or more", in emails, chat messages and the inbox. Keep values short and stable: when you change one, flows of the form are updated, but your website has to send the new value.
- Yes or no fields always send
yesorno, whatever their buttons say. - Country fields send the two letter ISO code, such as
DE, and show the name, "Germany". - A value that is not in the list fails the form rules, so a renamed option on your website and in Formpik must match.
Sending values
| Rule | Limit |
|---|---|
| JSON numbers and true or false | Stored as text, so 9 becomes "9". |
| Answers wrapped in a data object | Accepted: { "data": { "email": "..." } } reads the same as the answers at the top level. |
| Keys starting with an underscore | Kept out of emails, messages and learned fields. |
| One answer | 10,000 characters |
| One list | 100 values |
| All answers together | 64 KB, and at most 200 keys |
| Files | 10 per submission, 10 MB each, 25 MB per request |
Common questions
Should I use multiple choice or multi-select?
Can I route on a country?
DE, AT, CH.