# All fields

Every kind of question and block you can add to a form, and when to use each one.

Add a field from the side panel of the builder, or press `/` and type its name. Click a field to set it up.

## Questions people answer

| Field | Use it for |
|---|---|
| **Short Answer** | A name, a title, anything that fits on one line |
| **Long Answer** | A message or a longer text |
| **Email** | An email address. It is checked that it looks like one |
| **Number** | A quantity, an age, a price. Only numbers are taken |
| **URL** | A web address, like `https://example.com`. It is checked that it is one, and you can take links to only some websites |
| **Phone** | A phone number of any country. The person picks the country, and the number is kept with its country code, like `+14155552671`. You can choose the country it opens on, or take numbers of some countries only |
| **Date** | A day, typed or picked from a calendar. You can set the earliest and latest date, and the days of the week it takes |
| **Time** | A time of day |
| **Date and time** | A day and a time. The time zone of the person is kept with it, so you know when it is for them |
| **Multiple Choice** | One option out of a few, as radio buttons |
| **Dropdown** | One option out of many, picked from a list |
| **Multi-Select** | Several options at once. Show them as checkboxes or as a dropdown with chips |
| **Checkbox** | One box to tick, like agreeing to terms. Make it required and the form cannot be sent until it is ticked |
| **Rating** | Stars from 1 up to the number you choose (3 to 20). In the question, pick the shape (star, heart, thumbs up, flame or bolt) and its colour |
| **Linear scale** | Numbers from 0 or 1 up to 500, with your own words under the first, the middle and the last, like "Not likely" and "Very likely". Fill the chosen number with a colour, or with a gradient (red to green, green to red, sunset, ocean, berry, or two colours of your own) where each number has its own colour |
| **Multiple choice grid** | A table with a row for each question and the same columns to choose from. One choice in each row |
| **Checkbox grid** | The same table, with any number of choices in each row |
| **File Upload** | A file from the person. See [Collect files](https://form.invoy.in/docs/guides/file-upload/) |
| **Calculation** | A total worked out from other answers. See [Show a total](https://form.invoy.in/docs/guides/calculation-widget/) |
| **Payment** | A payment inside the form. See [Take a payment](https://form.invoy.in/docs/guides/payment-widget/) |

Here is a Multi-Select, as a person sees it. Open it, pick a few options, and take one off again.

Rating and Linear scale take one tap. Try them.

### Numbering the options

Multiple Choice, Dropdown and Multi-Select can number their options. Turn on **Number the options** in the question's General tab, and write how the first one looks: `1` gives 1 2 3, `A` gives A B C, `(1)` gives (1) (2) (3), and `c` starts at c. Or click one of the ready ones. On Multiple Choice and Multi-Select the number or letter takes the place of the circle or box, in a small badge that fills with the form's colour when the option is chosen.

The numbering is only drawn on the form. What a person answers is still the option's own words, so putting the options in another order never changes what an answer means, and rules, emails, spreadsheets and the API see the words alone. In a Dropdown the numbers show in the list, not in the box once an option is chosen. An Other option is numbered after the others. The HTML for your own page has the words alone.

### Colouring the options

Multiple Choice, and Multi-Select shown as options, can colour their options. Turn on **Color-code options** in the General tab and pick one colour, or a gradient (red to green, sunset, ocean and more, or two colours of your own). With a gradient the first option takes its first colour and the last one its last. Each option is drawn in its colour, and fills with it when chosen. Like the numbering, it is only drawn: the answer is still the option's own words.

### An Other option

Multiple Choice, Dropdown and Multi-Select can have an **Other** choice. Turn on **Add an Other option** in the question's General tab, and give it a name of your own if you like. A person who picks it writes their own answer in a box that opens under the options, and you see what they wrote in the response. In the Validation tab you can set the fewest and the most characters they may write (up to 1,000 characters, the most by default).

## Blocks that show something

These take no answer. They help people read the form.

| Block | Use it for |
|---|---|
| **Text** | A paragraph, with lists and links |
| **Divider** | A line between two parts of the form |
| **Image** | A picture, from a link or from your [Media](https://form.invoy.in/docs/guides/media/) |

## What every question has

- **Label.** The question itself.
- **Help text.** A note for the person filling in the form. See [Help text](#help-text).
- **Placeholder.** Grey words inside a text box until the person types.
- **Required.** The form cannot be sent without an answer. See [Required and rules](https://form.invoy.in/docs/guides/validation/).
- **Width.** Full takes the whole row. Two Half fields sit side by side on a wide screen and stack on a phone.
- **Show in form.** Turn it off to keep a question in the builder without showing it.

## Rules and logic

Every question has a **Validation** tab and a **Logic** tab next to **General**. Validation checks the answer. Logic shows or hides the question. See [Show or hide questions](https://form.invoy.in/docs/guides/conditional-logic/).

## Help text

Help text is a note for the person filling in the form: what to write, in what format, or why you ask. Type it in **Help Text / Description** in the field's **General** tab. It can be up to 1,000 characters.

On the live form, a small **(!)** button shows next to the question. Clicking it opens the note. Line breaks you type are kept. With **Rich text** on, the note can have bold words, links, coloured words and a highlight too. The colours at the top are made for light and dark: each one is drawn in the tone that reads on the form's page in either mode. Any other colour stays exactly as you pick it.

## Choice options

Multiple Choice, Dropdown and Multi-Select have a list of options. Type in an option, then:

| Key | What it does |
|---|---|
| `Enter` | Adds a new option under this one |
| `Shift` + `Enter` | Starts a new line inside the same option |
| `Backspace` in an empty option | Deletes it and goes back to the one above |
| `Alt` + `↑` or `↓` | Moves the option up or down |

Paste several lines into an option and each line becomes its own option.

Click **Bulk Edit** to write all the options as text, one per line, or split by blank lines or commas. Click it again to go back to the list.

## Add a field from the keyboard

Press `/` in the builder to jump to the field search in the side panel. Type part of a field's name, pick one with `↑` and `↓`, and press `Enter` to add it. `Esc` leaves the search.

Press `?` to see every keyboard shortcut of the builder.
