# 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 | `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? |
| Email | `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](https://formpik.com/docs/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*

```html
<label for="full_name">Full name</label>
<input id="full_name" name="full_name" type="text" required>
```

*JSON*

```json
{
  "full_name": "Jane Cooper"
}
```

### 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*

```html
<label for="message">Message</label>
<textarea id="message" name="message" rows="4" minlength="10" maxlength="2000" required></textarea>
```

*JSON*

```json
{
  "message": "Hi, we would like to talk about a new website for our team. Could you share your availability next week?"
}
```

### 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*

```html
<label for="email">Email</label>
<input id="email" name="email" type="email" required>
```

*JSON*

```json
{
  "email": "jane@example.com"
}
```

### 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*

```html
<label for="phone">Phone</label>
<input id="phone" name="phone" type="tel">
```

*JSON*

```json
{
  "phone": "+1 415 555 0132"
}
```

### 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*

```html
<label for="guests">Number of guests</label>
<input id="guests" name="guests" type="number" min="1" max="20">
```

*JSON*

```json
{
  "guests": "1"
}
```

### 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*

```html
<label for="budget">Budget (EUR)</label>
<input id="budget" name="budget" type="number" step="0.01" min="0">
```

*JSON*

```json
{
  "budget": "2500"
}
```

### 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*

```html
<label for="website">Website</label>
<input id="website" name="website" type="url">
```

*JSON*

```json
{
  "website": "https://example.com"
}
```

### 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*

```html
<label for="address">Delivery address</label>
<textarea id="address" name="address" rows="3" autocomplete="street-address"></textarea>
```

*JSON*

```json
{
  "address": "1 Market Street\nSan Francisco, CA 94105"
}
```

## 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*

```html
<label for="start_date">Start date</label>
<input id="start_date" name="start_date" type="date">
```

*JSON*

```json
{
  "start_date": "2026-12-01"
}
```

### 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*

```html
<label for="preferred_time">Preferred time</label>
<input id="preferred_time" name="preferred_time" type="time">
```

*JSON*

```json
{
  "preferred_time": "14:30"
}
```

### 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*

```html
<label for="appointment">Appointment</label>
<input id="appointment" name="appointment" type="datetime-local" required>
```

*JSON*

```json
{
  "appointment": "2026-12-01T14:30"
}
```

## 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*

```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>
```

*JSON*

```json
{
  "topic": "sales"
}
```

### 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*

```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>
```

*JSON*

```json
{
  "liked": [
    "speed",
    "quality"
  ]
}
```

### 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*

```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>
```

*JSON*

```json
{
  "service": "website"
}
```

### 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*

```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>
```

*JSON*

```json
{
  "sessions": [
    "keynote"
  ]
}
```

### 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*

```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>
```

*JSON*

```json
{
  "existing_customer": "yes"
}
```

### 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*

```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>
```

*JSON*

```json
{
  "country": "US"
}
```

## 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*

```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>
```

*JSON*

```json
{
  "rating": "4"
}
```

### 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*

```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>
```

*JSON*

```json
{
  "recommend_score": "9"
}
```

### 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*

```html
<label for="team_size">Team size</label>
<input id="team_size" name="team_size" type="range" min="0" max="100" step="5">
```

*JSON*

```json
{
  "team_size": "50"
}
```

## 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.

*HTML*

```html
<label><input type="checkbox" name="consent" value="yes" required> I agree to the privacy policy</label>
```

*JSON*

```json
{
  "consent": "yes"
}
```

### 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*

```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*

```html
<input type="hidden" name="campaign" value="spring-campaign">
```

*JSON*

```json
{
  "campaign": "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*

```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*

```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*

```html
<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 |

> **Where these checks run**
>
> The same checks run in the builder preview, on the endpoint for every submission, at the endpoint's check-only `/validate` address, and in every **Validate** step with **Use the form's rules** on. With **Refuse answers that break the field rules** on in the form settings, the endpoint refuses what breaks them. Answers that are not filled in skip the format checks: an empty optional email is fine.

## 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` | Email | Refuses free mailboxes such as gmail.com, outlook.com and yahoo.com. |
| No throwaway emails | `block_disposable` | Email | 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](https://formpik.com/docs/sources#field-errors).

## 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*

```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>
```

*JSON*

```json
{
  "email": "jane@example.com",
  "sessions": ["keynote", "meetup"]
}
```

- 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

| 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?

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](https://formpik.com/docs/security).

## Next steps

- [Forms](https://formpik.com/docs/forms): Build the form and set its rules.
- [Send a submission](https://formpik.com/docs/api/submit): Every format the endpoint accepts.
- [Variables and templates](https://formpik.com/docs/templates): Use answers in emails and messages.
- [Flows](https://formpik.com/docs/flows): Route and compare answers.

---

Source: https://formpik.com/docs/field-types
