Skip to main content
Text questions collect typed input from respondents. There are six types, each optimised for a specific kind of data.

Short text

A single-line text input. Best for names, short answers, codes, or any brief free-form response. Short text question in the canvas
FieldTypeDefaultNotes
placeholderTextYour answer here…Hint text shown inside the empty input
default_valueTextPre-filled value the respondent can edit
max_lengthNumber250Maximum characters allowed (1–5000)
validation_patternEnumOptional format validation (see below)
custom_regexTextOnly shown when validation_pattern is custom
custom_error_messageTextError message shown when validation fails
Validation patterns:
ValueValidates
(none)No format validation
urlMust be a valid URL
alphabeticLetters only (a–z, A–Z)
alphanumericLetters and digits only
customMust match the regex in custom_regex

Long text

A multi-line text area. Best for open-ended feedback, comments, or any response that may be several sentences.
FieldTypeDefaultNotes
placeholderTextYour answer here…Hint text
default_valueTextPre-filled value
max_lengthNumber1000Maximum characters (1–10000)
min_lengthNumberMinimum characters required (0 or higher)

Number

A numeric input. Best for ages, quantities, scores, or any whole or decimal number.
FieldTypeDefaultNotes
placeholderText0Hint text
default_valueNumberPre-filled value
minNumber0Minimum accepted value
maxNumber100Maximum accepted value
stepNumberIncrement step for up/down controls
format_prefixTextText shown before the number (e.g. $)
format_suffixTextText shown after the number (e.g. kg)

Email

A text input validated as an email address. Best for collecting contact details.
FieldTypeDefaultNotes
placeholderTextname@example.comHint text
allowed_domainsText (comma-separated)Only these domains are accepted (e.g. company.com)
blocked_domainsText (comma-separated)These domains are rejected (e.g. gmail.com,yahoo.com)
allowed_domains and blocked_domains accept a comma-separated list. Entries are trimmed and empty values are removed automatically.

Phone

A phone number input with optional country code selection.
FieldTypeDefaultNotes
placeholderText+1 (555) 000-0000Hint text
default_valueTextPre-filled value
allow_country_selectionBooleantrueShows a country code picker
default_countryEnumUSDefault country when the picker is shown
strict_formattingBooleanEnforce E.164 phone number format
Supported default countries: US · GB · IN · CA · AU · FR · DE · JP · BR · MX · ZA

Date

A date picker. Best for appointment scheduling, date-of-birth, or any calendar date.
FieldTypeDefaultNotes
placeholderTextHint text
default_valueDatePre-filled date; respects all constraints below
formatEnumMM/DD/YYYYDisplay format (see below)
min_dateDateEarliest selectable date
max_dateDateLatest selectable date
disable_weekendsBooleanGreys out and blocks Saturdays and Sundays
disable_past_datesBooleanBlocks all dates before today
disable_future_datesBooleanBlocks all dates after today
default_to_currentBooleanPre-selects today’s date
Date formats:
ValueExample
MM/DD/YYYY01/31/2025
DD/MM/YYYY31/01/2025
YYYY-MM-DD2025-01-31

Next steps

Choice questions

Multiple choice, Checkbox, Dropdown, Yes/No, Picture choice, and Ranking.

Conditional branching

Route respondents based on their text or number answers.