Skip to content

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

FieldType in the APIGroupWhat your website sends
Short texttextBasicsText
Long texttextareaBasicsText, line breaks kept
EmailemailBasicsAn email address
PhonephoneBasics7 to 15 digits, with spaces, dashes or a leading +
NumbernumberBasicsA number, such as 12 or 4.5
AmountcurrencyBasicsA number, such as 2500 or 99.90, in the currency you pick
WebsiteurlBasicsA web address, with or without https://
AddressaddressBasicsText, line breaks kept
DatedateDate and timeYYYY-MM-DD, such as 2026-12-01
TimetimeDate and timeHH:MM in 24 hours, such as 14:30
Date and timedatetimeDate and timeYYYY-MM-DDTHH:MM, such as 2026-12-01T14:30
DropdownselectChoicesThe value of one option
Multi-selectmultiselectChoicesA list of option values, as name[] in HTML or an array in JSON
Single choiceradioChoicesThe value of one option
Multiple choicecheckboxChoicesA list of option values, as name[] in HTML or an array in JSON
Yes or noyesnoChoicesyes or no
CountrycountryChoicesA two letter country code, such as US or DE
RatingratingRatings and scalesA whole number from 1 to the number of stars
Opinion scalescaleRatings and scalesA whole number between the two ends of the scale
SlidersliderRatings and scalesA number between the minimum and maximum
ConsentconsentAdvancedyes when ticked, nothing when not
File uploadfileAdvancedA file in a multipart upload, up to 10 MB each
HiddenhiddenAdvancedText your page fills in
HeadingheadingLayoutNothing, it only shows text
Text blockparagraphLayoutNothing, it only shows text
DividerdividerLayoutNothing, 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:

FieldSentReads as
Short textJane CooperJane Cooper
Long textHi, 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?
Emailjane@example.comjane@example.com
Phone+1 415 555 0132+1 415 555 0132
Number11
Amount25002500 EUR
Websitehttps://example.comhttps://example.com
Address1 Market Street San Francisco, CA 941051 Market Street San Francisco, CA 94105
Date2026-12-012026-12-01
Time14:3014:30
Date and time2026-12-01T14:302026-12-01 14:30
DropdownsalesSales
Multi-select["speed","quality"]Speed, Quality
Single choicewebsiteWebsite
Multiple choice["keynote"]Morning keynote
Yes or noyesYes
CountryUSUnited States
Rating44 of 5
Opinion scale99 of 10
Slider5050
ConsentyesYes
File upload["brief.pdf","moodboard.png"]brief.pdf, moodboard.png
Hiddenspring-campaignspring-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.
HTML
<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.
HTML
<label for="message">Message</label>
<textarea id="message" name="message" rows="4" minlength="10" maxlength="2000" required></textarea>

Email

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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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:MM in 24 hours, seconds optional. Otherwise "Enter a valid time, such as 14:30".
  • Settings: Help text.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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: yes or no, otherwise "Choose one of the listed options".
  • Settings: The text of each button, such as "Ja" and "Nein". The values stay yes and no.
HTML
<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.
HTML
<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.
HTML
<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".
HTML
<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.
HTML
<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.

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.
HTML
<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,.docx or image/*. Empty accepts any file.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<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.
HTML
<hr>

Required answers

A required field with no answer fails the form rules with a message that fits the type:

FieldsMessage
ConsentPlease accept to continue
File uploadPlease attach a file, or Please attach at least one file when several are allowed
Multiple choice and multi-selectChoose at least one option
Rating, opinion scale and yes or noPlease pick an answer
Every other typeThis 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.

RuleAPI nameField typesWhat it does
Fewest charactersmin_lengthShort text, Long text, Address, Email, WebsiteAnswers shorter than this are refused.
Most charactersmax_lengthShort text, Long text, Address, Email, WebsiteAnswers longer than this are refused.
Fewest wordsmin_wordsShort text, Long textFor messages that need some detail.
Most wordsmax_wordsShort text, Long textKeeps answers short.
PatternpatternShort text, Long textA regular expression the whole answer must match, such as ^[A-Z]{2}[0-9]+$ for order numbers.
Pattern messagepattern_messageShort text, Long textShown when the answer does not match the pattern.
Most linksmax_linksShort text, Long textLinks an answer may hold. 0 refuses every link, which stops most spam.
Blocked wordsblocked_wordsShort text, Long textAnswers holding any of these words or phrases are refused.
LowestminNumber, Amount, Slider, Opinion scaleNumbers and amounts: the lowest value. Sliders: the left end. Scales: 0 or 1.
HighestmaxNumber, Amount, Slider, Rating, Opinion scaleNumbers and amounts: the highest value. Sliders: the right end. Ratings: the number of stars. Scales: the top.
Whole numbers onlyintegerNumberRefuses 2.5 and other numbers with decimals.
Most decimalsmax_decimalsNumber, AmountDigits allowed after the decimal point, such as 2 for cents.
Fewest choicesmin_choicesMultiple choice, Multi-selectOptions a visitor must pick.
Most choicesmax_choicesMultiple choice, Multi-selectOptions a visitor may pick.
Only these domainsallowed_domainsEmail, WebsiteEmail: only addresses at these domains. Web address: only links to these sites. Subdomains count too.
Never these domainsblocked_domainsEmail, WebsiteEmail addresses or links on these domains are refused.
Work emails onlyblock_free_emailEmailRefuses free mailboxes such as gmail.com, outlook.com and yahoo.com.
No throwaway emailsblock_disposableEmailRefuses temporary mailboxes such as mailinator.com.
Secure links onlyrequire_httpsWebsiteThe address must start with https://.
International formatrequire_country_codePhoneThe number must start with + and a country calling code, such as +44 20 7946 0958.
Only these calling codesphone_prefixesPhoneNumbers must start with one of these, such as +1 or +44. Turns on the international format.
CountriescountriesCountryThe two letter codes the list keeps or leaves out, depending on country_mode. Visitors only see the countries that are left.
Country modecountry_modeCountryallow keeps only the listed countries, block offers every country except them.
Earliest datemin_dateDate, Date and timeAs YYYY-MM-DD.
Latest datemax_dateDate, Date and timeAs YYYY-MM-DD.
No past datesno_pastDate, Date and timeRefuses days before today, in UTC.
No future datesno_futureDate, Date and timeRefuses days after today, in UTC. For birthdays and past events.
Days of the weekweekdaysDate, Date and timeThe days that can be picked, 0 for Sunday to 6 for Saturday. Leave out to allow every day.
Earliest timemin_timeTime, Date and timeAs HH:MM, such as 09:00.
Latest timemax_timeTime, Date and timeAs HH:MM, such as 17:30.
Largest filemax_file_size_mbFile uploadIn MB, up to 10.
Most filesmax_filesFile uploadWhen several files are allowed, up to 10.
One per answeruniqueShort text, Email, Phone, Number, Website, HiddenRefuses an answer another submission of this form already used, such as one signup per email.
Error messagemessageEvery field that collects an answerShown 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.

HTML
<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 yes or no, 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

RuleLimit
JSON numbers and true or falseStored as text, so 9 becomes "9".
Answers wrapped in a data objectAccepted: { "data": { "email": "..." } } reads the same as the answers at the top level.
Keys starting with an underscoreKept out of emails, messages and learned fields.
One answer10,000 characters
One list100 values
All answers together64 KB, and at most 200 keys
Files10 per submission, 10 MB each, 25 MB per request

Common questions

Should I use multiple choice or multi-select?
Both send a list of option values and take the same limits. Multiple choice shows every option with a tick box, which suits short lists. Multi-select shows compact tags, which suits longer lists.
Can I route on a country?
Yes. Route by answer matches the two letter code. For groups of countries, use If / else with is any of and type the codes, such as DE, AT, CH.
Why does my yes or no field send yes when the button says Ja?
The button text is only a label. The values are always yes and no, so flows and your website never depend on the language of the form.
How does a consent field read when it is not ticked?
Unticked boxes send nothing. Templates read the field as "No", and the list of all answers leaves it out.
Where do uploaded files go?
Into private storage. The inbox opens each file through a link that works for 15 minutes. Answers and templates carry the file name. See Spam, privacy and security.

Next steps