Field types

Thirty-five types, in seven groups. The key column is what scripts, exports and integrations see; the name is what you pick in the builder.

Text and numbers

Type	Key	Stores, and what you can set
Text	`text`	One line. Min and max length, and a pattern the entry must match.
Long Text	`textarea`	Several lines. Same limits, plus how many rows to show.
Number	`number`	A whole number. Min, max and step.
Decimal	`decimal`	A number with decimal places. Min, max, step and precision.
Email	`email`	An address, checked for shape.
Masked Input	`masked`	Text forced into a pattern: phone, postcode, or a custom mask. Can hide the value behind dots with a reveal control.
Unique ID	`unique_id`	An identifier generated for the record: a UUID, a sequence, or a custom format with a prefix. Can be shortened to as few as 5 characters, which collides sooner.
Counter	`counter`	A number changed with plus and minus. Min, max and step.
Range / Slider	`range`	A number chosen on a slider. Min, max, step, whether to show the value.
Calculated	`calculated`	A value worked out by a formula. A real input unless read-only.

Dates and times

Type	Key	Stores
Date	`date`	A calendar date, `YYYY-MM-DD`. Earliest and latest allowed.
Time	`time`	A time of day. Shown as 12- or 24-hour.
Date & Time	`datetime`	Both, as ISO 8601. Earliest and latest allowed.

Media

Media is recorded against the record rather than inside the answer. On a phone, files wait on the device until there is signal.

Type	Key	Stores, and what you can set
Photo	`photo`	One or more photos. Max count, quality, whether the gallery is allowed as well as the camera, whether each must carry a timestamp.
Video	`video`	A recording, with a maximum duration.
Audio	`audio`	A recording, with a maximum duration.
Signature	`signature`	Drawn with a finger. Stroke width and colour.
Drawing	`drawing`	A free sketch on a canvas of a set size.
File Upload	`file`	A document. Can accept more than one.

Location and codes

Type	Key	Stores, and what you can set
GPS Location	`gps_location`	Latitude, longitude and accuracy. An accuracy threshold the fix must meet; whether to show a map.
Barcode	`barcode`	Scanned with the camera. Which formats to accept.
QR Code	`qrcode`	Scanned with the camera.

Choices

A choice field either carries its own options or points at a Smart List. Either way the record stores the option’s value; exports and documents show its label.

Type	Key	Stores, and what you can set
Yes/No	`yes_no`	`true` or `false`.
Single Choice	`single_choice`	One option, shown as buttons. Can allow an “Other” entry.
Multiple Choice	`multi_choice`	Several options, stored as a list. Min and max selections; can allow “Other”.
Dropdown	`dropdown`	One option from a list.
Searchable Choice	`lookup`	One option from a long list, found by typing. The key is `lookup` for historical reasons; it does not look records up.
Rating	`rating`	A score out of a maximum, shown as stars, hearts or thumbs.

Structure

These hold no answer. They never appear in an export, a document or a webhook, and a script cannot read them.

Type	Key	Does
Section	`section`	Groups the fields inside it under a heading.
Repeatable Section	`repeatable_section`	A group the person can add rows of. Rows live inside this record, as a list under the section’s key. Min and max rows.
Label / Instructions	`label`	Text shown on the form. Nothing is entered.
Divider	`divider`	A rule across the form.

Records and people

Type	Key	Stores, and what you can set
Record Lookup	`record_lookup`	Pick a record from another form and copy chosen fields from it into this one. Copied, not linked. You choose the source form, which column identifies a record, which are searched, which are copied, and optional filters. The source form must allow use as a record source.
Subform	`subform`	Rows that are real records on another form, each linked to this one as its parent. Min and max entries.
Send to	`send_to`	Hand this record to somebody else to carry on with. Only people who can collect on the form are offered.

Three switches every type has

Required refuses submission without an answer. Read-only shows and stores the value but stops anyone typing over it. Hidden keeps the field out of the form entirely while still carrying its value. Read-only and hidden are different things: one is shown and locked, the other is not shown at all.