# Question types

Reference for every question type in the Pristo CX form builder: what each one collects, its settings and limits, and which plan it needs.

This page lists every question type you can add in the Pristo CX form builder, with what it collects, its settings and its limits. It is for account admins and program admins who build questionnaires.

## Adding a question

In the editor, point between two rows and select the plus sign. The list of question types opens with two tabs: **Popular** shows the most used entries, and **All** shows every entry in groups. Select an entry to add it, then select the new question to change its settings in the settings panel.

Some entries need the Standard or Pro plan. On the Free plan they show a lock icon and the tooltip **Please upgrade to use this feature**, and selecting them does nothing. See [Plans and limits](https://docs.pristo.io/cx/get-started/plans-and-limits).

## Summary

The **All** tab has these groups and entries. Several entries are presets of one question type, with settings already filled in.

| Group | Entry | What it collects | Plan |
|---|---|---|---|
| **INPUT FIELDS** | **Text** | Typed text | All plans |
| | **Number** | A number, with an optional range and decimals | All plans |
| | **Digits** | Digits only | All plans |
| | **Email address** | Text checked as an email address | All plans |
| | **Phone number** | Text checked as a phone number | All plans |
| **SINGLE / MULTIPLE CHOICE** | **Checkbox** | One tick box, checked or not | All plans |
| | **Single Choice** | One answer from a list shown as buttons | All plans |
| | **Yes/no question** | Yes or no | All plans |
| | **Checklist** | Several answers from a list | All plans |
| | **Dropdown** | One answer from a dropdown list | All plans |
| | **Multiselect** | Several answers from a dropdown list | All plans |
| | **Countries**, **Months**, **Week Days** | One answer from a ready-made dropdown list | All plans |
| | **Gender** | One answer from two ready-made choices | All plans |
| **DATE / TIME** | **Date**, **Time**, **Date/Time** | A date, a time, or both | All plans |
| **RATING SCALES** | **Smiley rating scale** | A rating on 3 or 5 faces | All plans |
| | **Numeric rating scale** | A number on a scale between 0 and 10, such as an NPS question | All plans |
| **GRIDS** | **Scale grid** | One answer for each row of a table | Standard or Pro |
| | **Checkbox grid** | Several answers for each row of a table | Standard or Pro |
| **ATTACHMENTS** | **Upload file** | Files from the respondent's device | Standard or Pro |
| | **Camera**, **Video**, **Audio** | A photo, a video or a sound recording made on the spot | Standard or Pro |
| **DESIGN ELEMENTS** | **Text Block** | Nothing. Shows formatted text | All plans |
| | **Image** | Nothing. Shows an image | Standard or Pro |
| **MISC** | **Counter** | A number set with plus and minus buttons | Standard or Pro |
| | **Gps Picker** | The respondent's current location | Standard or Pro |
| | **Signature** | A drawn signature or a typed full name | Standard or Pro |

The **Popular** tab lists **Text**, **Digits**, **Email address**, **Phone number**, **Checklist**, **Checkbox**, **Single Choice**, **Text Block**, **Image**, **Yes/no question**, **Gender**, **Smiley rating scale** and **Numeric rating scale**. In this release, **Image** has no lock in this tab on any plan.

## Settings most questions share

| Setting | What it does |
|---|---|
| **Title** | The question text, up to 250 characters. Type @ to insert a merge field, such as the contact's name or the event date |
| **Description** | Help text under the question, up to 250 characters |
| **Required** | The respondent must answer before going on |
| **Show conditions** | **Always** by default. Choose a condition to show the question only when it is true. See [Show or hide questions with conditions](https://docs.pristo.io/cx/form-builder/conditions) |
| **Data field ID** | The question's fixed ID. You cannot edit it |

The **More** menu (⋮) at the top of the settings panel has **Duplicate**, **Duplicate to page**, **Move to page** and **Delete controller**. You cannot delete a question that a condition or an exit point uses; the builder lists where it is used.

## Details

### Text and number fields

**Text**, **Number**, **Digits**, **Email address** and **Phone number** are one question type with four kinds of input, set in **Input type**, then **Type**.

| Setting | Options |
|---|---|
| **Type** | **Text**, **Digits**, **Number** or **Mask** |
| **Placeholder** | Text shown while the box is empty, up to 100 characters |
| **Default Value** | Up to 1,000 characters |
| **Hide text with asterix** | Shows asterisks instead of the typed text |
| **Text length** | Text and digits: a minimum and maximum length, from 0 to 4,000 characters |
| **Number of rows** | Text and digits: the height of the box, 1 to 5 rows |
| **Validation** | Text only: **None**, **Email Address**, **Phone Number**, **Url**, **IP Address** or **Alphanumeric** |
| **Range** | Number only: a minimum and maximum between -999,999,999 and 999,999,999 |
| **Decimal places** | Number only: 0 to 4 |
| **Mask expression** | Mask only: a pattern of up to 100 characters, where N is a number, T is a letter and C is a number or a letter |

### Choice lists

**Single Choice** and **Dropdown** collect answers from a list of choices, and the other entries in their group, except **Checkbox**, are presets of them. **Single Choice** shows the choices as buttons, and **Dropdown** shows them in a dropdown list. Switch between them in **Field type**.

| Setting | Options |
|---|---|
| Choices | Select **Edit choices** on the question in the editor. Type a choice, or paste a list with one choice per line. Each choice has a text of up to 250 characters, a key value of up to 50 characters, a default flag, an optional extra text box and an optional show condition |
| Number of choices | Up to 100 in **Single Choice** and up to 1,500 in **Dropdown** |
| **Enable multiple select** | Lets respondents pick several choices. Adds **Show "Select All"** and a minimum and maximum number of choices, from 0 to 100 |
| **Placeholder**, **Is searchable** | Only for **Dropdown**. A searchable dropdown lets respondents type to filter the list |
| **Default Value** | Read-only here. Mark default choices in the list of choices |

### Single checkbox

**Checkbox** collects one tick box, checked or not.

| Setting | Options |
|---|---|
| **Label** | The text beside the tick box, up to 250 characters |
| **Check by default** | The box starts checked |
| **Open extra text box** | Adds a text box, with its own **Required**, **Numeric** and **Text length** (0 to 4,000 characters) |

### Date and time

**Date**, **Time** and **Date/Time** are one question type. The entry sets the starting mode and display format.

| Setting | Options |
|---|---|
| **Mode** | **Date and Time**, **Date** or **Time** |
| **Display format** | For example `MM/dd/yyyy`, `dd/MM/yyyy`, `MMMM dd yyyy`, `HH:mm` or `H:mm tt` |
| **Input type** | **Picker** opens a calendar or a time picker. With **Button**, respondents can only record the current date and time with a button. **Both** shows the button beside the picker |
| **Range** | The earliest and latest date or time allowed |
| **Default Value** | A date or time filled in at the start |

### Smiley scale

**Smiley rating scale** asks for a rating on a row of faces.

| Setting | Options |
|---|---|
| **Number of options** | 3 or 5 faces. The default is 5 |
| **Labels** | **Lowest**, **Middle** and **Highest**, plus **Low** and **High** with 5 faces |

### Numeric scale

**Numeric rating scale** asks for a rating on a row of numbers.

| Setting | Options |
|---|---|
| **Number of options** | The first and last number, between 0 and 10. The default is 0 to 10 |
| **Labels** | **Min** and **Max**, the texts at the two ends |

### Grids

**Scale grid** and **Checkbox grid** are one question type: a table where each row is a question and each column is an answer. Select **Edit grid** on the question to edit the rows, the columns and their key values. Turn on **Enable multiple select** to allow several answers in each row. **Scale grid** starts with 3 rows and 5 columns from very dissatisfied to very satisfied.

### Attachments

**Upload file**, **Camera**, **Video** and **Audio** are one question type. The entry decides which upload types start turned on and how the upload area first looks: a list for **Upload file**, thumbnails for the others.

| Setting | Options |
|---|---|
| **Uploads view type** | **List** or **Thumbnails** |
| **Upload type** | **Camera**, **Video**, **Audio** and **File**. At least one stays on |
| File types | With **File**: `jpg`, `jpeg`, `png`, `pdf`, `txt`, `docx`, `doc`, `xlsx`, `xls`, `mp4`, `mov`, `mp3` and `wav`. All are allowed by default |
| **Accepted number of files** | A minimum and maximum number of files, from 0 to 10 |
| **Max resolution** | 640, 768, 1024, 1200, 1600 or 2000 pixels. The default is 1024 |
| **Max file size** | 5, 10, 20, 50 or 100 MB per file. The default is 10 MB |

### Number counter

**Counter** collects a number that respondents set with plus and minus buttons.

| Setting | Options |
|---|---|
| **Default Value** | The starting number |
| **Increment** | How much each press adds or removes. The default is 1 |
| **Range** | A minimum and maximum between -999,999,999 and 999,999,999. The default is 0 to 100 |

### Location

**Gps Picker** has only the shared settings. Respondents select **Click to get current location**, and their browser asks for permission to share the location.

### Signature

**Signature** has only the shared settings. The respondent form shows **Draw your signature in the box, or type your full name instead.** as the instruction.

### Formatted text

**Text Block** shows formatted text and collects no answer. Its text holds up to 4,000 characters, with sizes from 12 to 32 pixels, bold, italic, underline, alignment and right-to-left direction. Its only setting is **Show conditions**.

### Images

**Image** shows a picture and collects no answer. Choose an image from the program's images or upload a PNG or JPEG file of up to 10 MB, then set **Image width** (10% to 100%, in steps of 10), **Alignment** (**Start**, **Center** or **End**) and **Alt text** for screen readers.

## Limits

| Item | Limit |
|---|---|
| Questions on a page | 250 |
| Questions in a section | 100 |
| Questions in a chapter | 500 |
| Sections on a page | 15 |
| Section title | 250 characters |

## Related

- [Form builder overview](https://docs.pristo.io/cx/form-builder/overview)
- [Add and organize pages in a questionnaire](https://docs.pristo.io/cx/form-builder/chapters-and-pages)
- [Preview a questionnaire](https://docs.pristo.io/cx/form-builder/preview)
- [Glossary](https://docs.pristo.io/cx/glossary)