# Inputs

Input blocks collect information from the user — text, numbers, dates, choices, files, and more. Each input block captures the user’s response and stores it in a variable for use later in the flow.

---

## Text

Collects a free-text response from the user.

**Configuration**

| Field | Description |
| --- | --- |
| Placeholder | Hint text shown inside the input field. |
| Button label | Label on the submit button. |
| Long text | When enabled, shows a multi-line textarea instead of a single-line input. |
| Attachments | When enabled, allows the user to upload files alongside the text response. |
| Save attachments in variable | Variable to store uploaded file references. |
| Attachment visibility | Who can see the uploaded attachments. |
| Variable | Variable where the user’s text response is stored. |

---

## Number

Collects a numeric value from the user. Validates that the response is a number.

**Configuration**

| Field | Description |
| --- | --- |
| Min | Minimum accepted value. |
| Max | Maximum accepted value. |
| Step | Increment step for numeric controls. |
| Placeholder | Hint text shown inside the input. |
| Button label | Label on the submit button. |
| Variable | Variable where the numeric response is stored. |

---

## Email

Collects an email address from the user. Validates the format before proceeding.

**Configuration**

| Field | Description |
| --- | --- |
| Placeholder | Hint text shown inside the input. |
| Button label | Label on the submit button. |
| Retry message | Message shown when the email format is invalid. |
| Variable | Variable where the email address is stored. |

---

## Website

Collects a URL from the user. Validates the URL format before proceeding.

**Configuration**

| Field | Description |
| --- | --- |
| Placeholder | Hint text shown inside the input. |
| Button label | Label on the submit button. |
| Retry message | Message shown when the URL format is invalid. |
| Variable | Variable where the URL is stored. |

---

## Date

Presents a date picker and collects a date (and optionally a time) from the user.

**Configuration**

| Field | Description |
| --- | --- |
| Has time | When enabled, includes a time selector alongside the date picker. |
| Is range | When enabled, allows the user to select a date range (from/to). |
| Format | Date format string for the stored value. |
| Min | Earliest selectable date. |
| Max | Latest selectable date. |
| Button label | Label on the confirm button. |
| From label | Label for the start date in range mode. |
| To label | Label for the end date in range mode. |
| Variable | Variable where the selected date(s) are stored. |

---

## Phone

Collects a phone number from the user. Includes a country code selector.

**Configuration**

| Field | Description |
| --- | --- |
| Placeholder | Hint text shown inside the input. |
| Button label | Label on the submit button. |
| Default country code | Pre-selected country code (e.g., `+1` for US). |
| Retry message | Message shown when the phone format is invalid. |
| Variable | Variable where the phone number is stored. |

---

## Buttons

Presents a set of clickable buttons for single or multiple-choice selection.

**Configuration**

| Field | Description |
| --- | --- |
| Options (items) | List of button labels. Each item can have a display condition. |
| Multiple choice | When enabled, the user can select more than one option. |
| Button label | Label on the confirm button (shown in multiple-choice mode). |
| Dynamic variable | Variable containing a list of options to generate buttons dynamically at runtime. |
| Searchable | When enabled, adds a search field above the buttons. |
| Search placeholder | Hint text for the search input. |
| Variable | Variable where the selected option(s) are stored. |

---

## Picture Choice

Presents image-based options for single or multiple-choice selection.

**Configuration**

| Field | Description |
| --- | --- |
| Options (items) | Each item has a picture URL, title, and description. Items can have display conditions. |
| Multiple choice | When enabled, the user can select more than one option. |
| Button label | Label on the confirm button in multiple-choice mode. |
| Dynamic items | When enabled, populates items from variables at runtime (titles, descriptions, picture URLs). |
| Searchable | When enabled, adds a search field. |
| Variable | Variable where the selected option(s) are stored. |

---

## Rating

Collects a numeric rating from the user via stars or a number scale.

**Configuration**

| Field | Description |
| --- | --- |
| Button type | `Icons` (star icons) or `Numbers` (numeric scale). |
| Length | Number of rating options (e.g., 5 for a 5-star scale). |
| Starts at | Starting value of the scale (typically 0 or 1). |
| Left label | Label displayed at the low end of the scale. |
| Right label | Label displayed at the high end of the scale. |
| Button label | Label on the submit button. |
| Custom icon | When enabled, uses a custom SVG icon instead of the default star. |
| One-click submit | When enabled, selecting a rating submits immediately without a confirm button. |
| Variable | Variable where the rating value is stored. |

---

## File

Allows the user to upload one or more files.

**Configuration**

| Field | Description |
| --- | --- |
| Required | When enabled, the user must upload at least one file before proceeding. |
| Multiple allowed | When enabled, the user can upload more than one file. |
| Placeholder label | Hint text on the upload area. |
| Button label | Label on the upload/confirm button. |
| Clear label | Label on the remove-selection button. |
| Skip label | Label on the skip button (shown when **Required** is off). |
| Success label (single) | Confirmation message shown after one file is uploaded. |
| Success label (multiple) | Confirmation message shown after multiple files are uploaded. |
| Visibility | Who can see the uploaded files. |
| Variable | Variable where file references are stored. |
