> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dforms/builder/question-types.md).
# Question types
The 14 question types in dForms, grouped as Contact, Choice, Text and Content: how to add a question from the gallery, search it, and switch a question's type later.
Every step in a form is a question (or a content step) picked from the **Add a question** gallery. The gallery groups the 14 tiles into four families so you can find the right one quickly. Each family has its own page with every setting explained.
***
## Open the gallery
Click **Add question** in the toolbar (or the dashed **Add question** card at the bottom of the question list). The **Add a question** dialog opens with a **Search question types** box and the four groups.
Type in Search question types to filter the tiles. Picking a type drops the question in and focuses the canvas to edit it.
Clicking a tile adds the question at the end of the form, on a screen of its own, selects it and puts the cursor in the canvas so you can type the question text immediately. On a brand-new form, **Start from scratch** opens this same gallery. To show it together with the question above, see [Several questions on one screen](/dforms/builder/screens.md).
***
## The 14 types
| Group | Type | Gallery hint | What it collects | Page |
| ----------- | ------------------- | ------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Contact** | **Name** | Full name field | First and last name on one screen (two fields, two keys) | [Contact fields](/dforms/builder/question-types/contact-fields.md) |
| **Contact** | **Email** | Validated email | An email address, optionally restricted to work domains | [Contact fields](/dforms/builder/question-types/contact-fields.md) |
| **Contact** | **Phone** | Number with country | A phone number with a country code picker, stored in international format | [Contact fields](/dforms/builder/question-types/contact-fields.md) |
| **Choice** | **Single choice** | Pick one | One option from a list or a grid of cards; advances on tap when it is alone on its screen | [Choice fields](/dforms/builder/question-types/choice-fields.md) |
| **Choice** | **Multiple choice** | Pick several | Any number of options; respondents confirm with the button | [Choice fields](/dforms/builder/question-types/choice-fields.md) |
| **Choice** | **Dropdown** | Compact list | One option from a searchable, compact list; advances on pick when it is alone on its screen | [Choice fields](/dforms/builder/question-types/choice-fields.md) |
| **Text** | **Short text** | One line | A single line of free text | [Text & scale fields](/dforms/builder/question-types/text-and-slider-fields.md) |
| **Text** | **Long text** | Paragraph | A multi-line paragraph | [Text & scale fields](/dforms/builder/question-types/text-and-slider-fields.md) |
| **Text** | **Website** | Validated URL | A web address, normalized to `https://` | [Text & scale fields](/dforms/builder/question-types/text-and-slider-fields.md) |
| **Text** | **Slider** | Rating scale | A number on a scale you define (min, max, step) | [Text & scale fields](/dforms/builder/question-types/text-and-slider-fields.md) |
| **Text** | **File upload** | A document or image | One file, of the types and size you allow | [File upload](/dforms/builder/question-types/file-upload.md) |
| **Content** | **Message** | Text, no input | A screen with text only and a button; nothing is collected | [Content steps](/dforms/builder/question-types/content-steps.md) |
| **Content** | **Reveal screen** | A short processing pause | A timed "reviewing your answers" interstitial | [Content steps](/dforms/builder/question-types/content-steps.md) |
| **Content** | **Scheduler** | Book a meeting on your calendar | A Calendly booking; the booking counts as the answer | [Content steps](/dforms/builder/question-types/content-steps.md) |
> **đź’ˇ Tip:** Choice, Dropdown and Slider questions can carry points and feed [Scoring](/dforms/logic/scoring.md). Contact and Text fields never affect the score; Message and Reveal screen collect nothing at all.
***
## Switch a question's type
You do not have to delete a question to change its kind. Select it, and in the **Question settings** pane on the right use the **Question type** select at the top. The question text, description and field key are kept; settings that do not apply to the new type disappear and the new type's settings appear.
Single choice and Multiple choice are two modes of the same question, so switching between them keeps your options, values, points and icons. Switching a choice question into a text or contact type drops the option list.
Schedulers, reveal screens and file uploads always get a screen of their own. If you switch a question that shares a screen to one of those types, it moves off that screen.
***
## Settings every question shares
Whatever the type, the **Question settings** pane offers the same core controls:
| Setting | Where | What it does |
| ------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Question text | Canvas, **Type your question…** | The prompt respondents read. Type `@` or `[` to insert an earlier answer ([Recall answers with @](/dforms/builder/recall-answers.md)). |
| Description | Canvas, **Add a description (optional)** | Helper text under the title, up to 1000 characters. |
| Button text | **Design → Button text** | **Next** on a question and **Submit** on the last step, in the form's language. You can change **Next** and **Submit** for the whole form, not per question, and the button is not editable on the canvas. A **Message** reads **Continue** in every language. A **Single choice** or **Dropdown** alone on its screen and a **Scheduler** show no button. See [Language & button text](/dforms/design/language-and-button-text.md). |
| **Required** | Settings | On by default. Hidden for Message and Reveal screen because they collect nothing. |
| **Placeholder** | Settings | Ghost text shown inside the input while it is empty. Only for Short text, Long text, Email, Website and Dropdown. |
| **Default answer** | Advanced settings | Used when the link carries no value; anything in the URL wins over this. |
| **Field key** | Advanced settings | The name the answer is stored under; also the URL parameter that prefills it and the `[key]` reference that recalls it in later copy. |
| **Show on the same screen as the question above** | Settings, after **Logic** (Slides only) | Groups this question with the one above on a single screen. See [Several questions on one screen](/dforms/builder/screens.md). |
See [Question settings](/dforms/builder/question-settings.md) for the full list, including **Hidden question** and **Ends the form**.
## What's next
* [Contact fields: Name, Email, Phone](/dforms/builder/question-types/contact-fields.md)
* [Choice fields: Single, Multiple, Dropdown](/dforms/builder/question-types/choice-fields.md)
* [Text & scale fields: Short text, Long text, Website, Slider](/dforms/builder/question-types/text-and-slider-fields.md)
* [File upload](/dforms/builder/question-types/file-upload.md)
* [Content steps: Message, Reveal screen, Scheduler](/dforms/builder/question-types/content-steps.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dapta.ai/dforms/builder/question-types.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
