Questions
A question is a block with kind: "field":
{ "kind": "field", "key": "email", "type": "email", "label": "Work email", "required": true, "placeholder": "maya@northwind.co", "autocomplete": "email"}Every type
Section titled “Every type”| type | What it is | Its own properties | Its answer |
|---|---|---|---|
text | One line | minLength, maxLength (500), pattern | string |
textarea | Several lines | minLength, maxLength (5000), rows | string |
email | An email address | — | string |
phone | A phone number | defaultCountry | string, as typed |
url | A web address | "northwind.co" is accepted | string, with https:// |
number | A number | min, max, step, integer, prefix, suffix, unitPrice | number |
choice | Pick one or several | display, options, multiple, minSelected, maxSelected, other | an option's value, or an array of them |
checkbox | One tick box | price (added when ticked) | boolean |
consent | Agreeing to exact wording | body | boolean |
quantity | A stepper | max (required), min, step, unitPrice, unitLabel | integer |
date | A date | min, max (a date, or today, +5d, +3m), disabledWeekdays, blockedDates | "YYYY-MM-DD" |
time | A time | min, max, stepMinutes | "HH:mm" |
file | File upload | accept, maxSizeMB, maxFiles (1, at most 10) | a list of files |
rating | Stars or a number scale | max (5 or 10), display, min, minLabel, maxLabel | integer |
hidden | A value the visitor doesn't see | source: { query }, { const } or { page } | string |
payment | A card payment, through Stripe | amount: { fixed }, { from: "total" | "deposit" } or { expr } | the payment, set by our server |
booking | A date and time from the owner's calendar | durationMinutes, daysAhead (14) | the booking, set by our server |
What every question can have
Section titled “What every question can have”keystringrequired- The answer’s name. Frozen at first publish.
typestringrequired- One of the types above.
labelstringrequired- Always there, for screen readers, even when hidden with
labelHidden. dataLabelstring- The column name in exports and apps. Defaults to the label.
helprich text- A line of help under the question.
placeholderstring- Shown in an empty field.
requiredboolean- Must be answered.
requiredWhenCondition- Must be answered when this is true.
visibleWhenCondition- Only shows when this is true.
defaultanswer- The value it starts with.
prefill{ param }- Fills in from the page’s address:
{ "param": "plan" }reads?plan=…. Ignored on consent, file, payment, booking and hidden questions. autocompletestring- An HTML
autocompletetoken, such asemailorpostal-code. widthfull | half | third- A hint. Questions stack on a phone.
messagesobject- Your own wording for this question’s errors.
introstring- In a conversational form, a line above the question.
personalboolean- Marks an answer as personal. Nothing reads it yet: finding a person searches every answer.
readOnlyboolean- Shown but can’t be changed.
Choices
Section titled “Choices”{ "kind": "field", "key": "budget", "type": "choice", "label": "What's your budget?", "display": "cards", "options": [ { "value": "under-10k", "label": "Under $10k" }, { "value": "10k-25k", "label": "$10k–$25k", "description": "Most projects" }, { "value": "25k-plus", "label": "$25k+" } ], "other": { "label": "Something else" }}displayisradio,chips,cards,segment,dropdown,swatchorimage. Every one is a real radio button or tick box underneath.- A question has 1 to 24 options, or up to 500 in a
dropdown. - An option’s
valueis what answers, logic and apps use, never its label. An option can have aprice, added when it’s picked. - With
other, picking it sets the answer toother, and what the visitor typed arrives as a separate answer,<key>__other.
A file answer is a list of { id, name, size, type }. In a webhook or the API each also has a url, and files are served from their own domain with Content-Disposition: attachment, so an uploaded page can never run as your site.
ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks