Field Types Reference

The form builder ships with 48 field types organized into 7 categories in the left palette. This page is the quick-reference catalog - what each field does and where it stores its value. For per-field configuration options, jump to Field Properties, Validation, and field-specific deep dives linked below.

Contact & Personal​

Specialty fields pre-mapped to common contact properties in your CRM. Drag one and the Save to Contact Field mapping is set automatically.

Field	Type ID	What It Renders	Maps To
First Name	first_name	Text input	Contact first_name
Last Name	last_name	Text input	Contact last_name
Full Name	full_name	Side-by-side First + Last sub-inputs	Splits into Contact first_name + last_name
Email	email	Email input with format validation	Contact email
Phone	phone	Phone input with country selector + libphonenumber validation	Contact phone
Gender	gender	Dropdown: Male / Female / Non-binary / Prefer not to say	Contact gender
Date of Birth	dob	Date picker	Contact date_of_birth
Age	age	Number input	Custom property
Job Title	job_title	Text input	Contact job_title
Company	company	Text input	Contact company
Country	country	Country dropdown (popular at top, full list below)	Contact country
City	city	Text input	Contact city
Zip / Postal Code	zip_code	Text input	Contact zip_code
Website	website	URL input with format validation	Contact website
Contact Info (Bundle)	contact_info	Multi-input combining Name + Email + Phone + Company per options	All four contact fields at once
Address	address	Multi-input: street, optional Apt/Suite, city, state, ZIP, country	Address fields on contact

See Field Properties for the contact mapping list.

Input Fields​

Plain inputs without a pre-set contact mapping. You can still map them with Save to Contact Field in the Properties tab.

Field	Type ID	What It Renders
Text Input	text	Single-line text input
Text Area	textarea	Multi-line text area, resizable
Number	number	Numeric input with min/max/step + optional prefix/suffix (e.g. $ / %)
URL	url	URL input, validates as http:// or https://
Password	password	Password input with show/hide eye toggle, configurable strength rules

Choice Fields​

Pick from a list of options.

Field	Type ID	What It Renders	Stores
Dropdown	select	<select> (or searchable combobox if searchable is on)	Single chosen value
Multi Select	multi_select	Checkbox group	Comma-separated chosen values
Checkbox	checkbox	Checkbox group	Comma-separated chosen values
Radio	radio	Radio button group	Single chosen value
Toggle	toggle	Single checkbox styled as a toggle	'true' / 'false'
Yes / No	yes_no	Two big buttons (👍 Yes / 👎 No)	'yes' / 'no'
Picture Choice	picture_choice	Image-card buttons in a 2/3/4 column grid	Single chosen value (or comma-separated if multiSelect is on)

The Dropdown also supports two extras:

• Searchable - replaces the native <select> with a custom combobox that has a search input
• Allow "Other" - adds an "Other…" option that reveals a free-text input

See Field Properties → Choice options for option editing.

Date & Time​

Field	Type ID	What It Renders
Date	date	Native <input type="date">
Time	time	Native <input type="time">
Date & Time	datetime	Native <input type="datetime-local">

All three accept a defaultValue (in standard ISO format).

Advanced​

Field	Type ID	What It Renders	Notes
File Upload	file_upload	Drop-zone with click-to-browse	Configurable: max size (MB), allow multiple, accepted types (Images / PDF / Word / Excel / Video / Audio); files upload to your tenant's attachment storage and the URL is stored on the submission
Signature	signature	Click-to-sign canvas	Captures a base64 PNG signature data URL
Rating	rating	Star, number, or emoji buttons	Configurable: rating type (stars / numbers / emojis), maxRating (2–10), low and high labels under the row
Opinion Scale	opinion_scale	Numbered button row	Configurable: min (default 0), max (default 10), low/mid/high labels
NPS	nps	0–10 numbered button row	Standard Net Promoter Score scale
Ranking	ranking	Drag/up-down list of items	Stores ordering as comma-separated values
Matrix	matrix	Table of rows × column radios	Stores a value per row
Hidden	hidden	Not rendered	Submitted with a fixed value or seeded from URL params
Payment	payment	Stripe payment element + amount/products	Donations, products, or user-defined amounts; see Payment Fields

Conversational​

These three are most useful in conversational forms but can be dropped on Premium forms too.

Field	Type ID	Renders
Statement	statement	A non-interactive text block - used for notes, intros, or section commentary
Question Group	question_group	A titled group container - useful as a screen heading in conversational forms
Consent	consent	A required checkbox with a custom legal/agreement label (e.g. "I agree to the terms")

Layout​

Field	Type ID	Renders
Section	section	A titled section with optional description and collapsible toggle
Divider	divider	A horizontal line
Spacer	spacer	Vertical empty space (configurable height in px)
Page Break	page_break	A subtle step indicator between groups of fields
Button	button	Custom button - submit, open a URL in a new tab, or advance to the next page

Per-Field Width​

Every field has a Style → Field Width option:

• Full (default) - spans the form width
• 1/2 - half-width column
• 1/3 - third-width column

Adjacent fields with widths smaller than Full automatically lay out side-by-side in a 6-column grid. See Style & Design.

---

Next Steps​

• Field Properties - Common settings (label, placeholder, default, required, save-to-contact)
• Validation - Validation rules per field
• Conditional Logic - Show/hide based on other field values
• Style & Design - Width, label position, theming
• Payment Fields - Selling products, taking donations, collecting cards