Field Properties

Click any field on the canvas and the right panel shows that field's tabs: Properties, Validation, Logic, Style. This page documents the Properties tab — the common settings every field has, plus the type-specific panels that appear for fields with extra config.

Common Properties​

These appear on (almost) every field type:

Label​

The visible label rendered above the input. Required for accessibility — even if you set Style → Label Position to Hidden, screen readers will still announce it.

Example: Email address

Placeholder​

Hint text shown inside an empty input. Disappears once the user starts typing. Not all field types render a placeholder (toggles, ratings, date inputs, etc. may show theirs differently or not at all).

Example: you@company.com

Help Text​

Small caption text shown under the input. Use for clarification, format hints, or privacy notes.

Example: We'll never share your email.

Required​

Toggle. When on, the field must have a non-empty value before the form can submit. The label gets a red asterisk (or "(required)" text — see Form Settings → Required Indicator).

For toggles and consent fields, "non-empty" means true (checked). An unchecked required consent blocks submission.

Save to Contact Field​

A dropdown that maps this field's value to a property on the lead/contact created from each submission. Pick from:

Mapping	Stores to
Don't save to contact	(no mapping — lives only on the submission row)
Full Name (splits into first + last)	first_name + last_name
First Name / Last Name	first_name / last_name
Company / Job Title	company / job_title
Gender / Date of Birth / Password	corresponding contact field
Email / Secondary Email	email / secondary_email
Phone / Mobile Phone / Work Phone	corresponding contact phone
Website	website
Street Address / City / State / Province / Zip / Postal Code / Country	corresponding address fields
Notes	notes
Lead Source	lead_source
Lead Score	lead_score

Contact-typed palette items (First Name, Email, Phone, etc. in the Contact & Personal category) come pre-mapped — you don't need to set this manually.

Default Value​

Pre-fills the field with this value when the form loads. Visitors can still edit it. Useful for sensible defaults, prefilled phone country code, or branded suggestions.

Note: if a visitor lands with a cached lead ID (returning visitor), saved contact values override the default. URL-param hidden fields override both. See Hidden Fields & Variables.

Field-Type-Specific Panels​

Below the common properties, certain field types add their own configuration sub-panel.

Text Input + Phone — Text Options​

Setting	What It Does
Min Length	Minimum character count. Triggers an inline validation error if shorter.
Max Length	Maximum character count. Enforced as the HTML maxLength attribute too — typing past the limit is blocked.
Input Mask	Format pattern. # = digit, A = letter, * = either, anything else = literal. Auto-formats as you type.

Mask examples:

Mask	Type "123456789" → Becomes
###-##-####	123-45-6789 (US SSN)
(###) ###-####	(123) 456-789
AA-####	(letters only — non-letters discarded)

Number — Number Options​

Setting	What It Does
Min / Max	Numeric bounds. Enforced as HTML min/max and via inline validation.
Step	Increment for spinner arrows (e.g. 0.01 for currency, 1 for whole numbers).
Prefix	Text or symbol shown inside the input on the left (e.g. $).
Suffix	Text or symbol shown inside the input on the right (e.g. %).

When prefix or suffix is set, the number input is rendered inside a connected wrapper for the affixes.

Password — Password Rules​

Setting	What It Does
Min Length	Minimum character count (default 6).
Max Length	Maximum character count.
Require number	At least one digit.
Require uppercase	At least one uppercase letter.
Require lowercase	At least one lowercase letter.
Require special character	At least one of !@#$%^&*()_+-=[]{};':"|,.<>/?
Show confirm password field	Adds a second "Confirm Password" field that must match.

Choice fields (Dropdown / Multi Select / Checkbox / Radio) — Options List​

Edit the list of options for any choice field. Each option has:

• Label — what the visitor sees
• Value — what's submitted (auto-derived from the label, can be overridden)
• Reorder — up/down arrows on the left
• Delete — trash icon on the right
• Optional score for quiz scoring (see Hidden Fields & Variables)
• Optional imageUrl for Picture Choice

Click + Add Option to add a new row.

Dropdown also has:

• Default Selected — pick which option is pre-selected on form load
• Allow "Other" option — appends an "Other..." choice that opens a free-text input
• Searchable — replaces the native dropdown with a typeahead combobox

Rating — Rating Options​

Setting	What It Does
Rating Type	stars (★), numbers (1–N buttons), or emojis (face progression)
Max Rating	2–10
Low Label	Text shown under the leftmost option (e.g. Poor)
High Label	Text shown under the rightmost option (e.g. Excellent)

For emojis, the system spreads from 😡 → 👑 across the configured max.

File Upload — File Options​

Setting	What It Does
Max File Size (MB)	Reject uploads larger than this
Allow Multiple Files	Toggle — when on, exposes a Max Files spinner
Max Files	When multiple is on, limit the number of files
Accepted File Types	Pill-buttons: Images, PDF, Word, Excel, Video, Audio. Multiple can be on at once; if none are selected, all types are accepted.

Opinion Scale — Scale Options​

Setting	What It Does
Min / Max	Numeric range (default 0–10)
Low Label	Caption under the lowest number
Mid Label	Caption under the middle
High Label	Caption under the highest
Show Labels	Toggle whether the labels render

NPS — NPS Labels​

A simple two-field panel:

Setting	What It Does
Low Label	Caption under the 0 button (default Not likely)
High Label	Caption under the 10 button (default Very likely)

NPS is always 0–10, no other knobs.

Picture Choice — Picture Options​

The Options list (above) plus:

Setting	What It Does
Multi Select	Allow multiple picks
Show Labels	Toggle the label under each image
Columns	Grid columns (2 / 3 / 4)

Each option also has an imageUrl field for the picture.

Address — Address Options​

Setting	What It Does
Show Line 2	Toggle the optional Apt/Suite line
Default Country	Country code pre-selected in the dropdown (e.g. US)

Contact Info Bundle — Visible Sub-Fields​

Toggle which sub-inputs render:

• Show Name
• Show Email
• Show Phone
• Show Company

Statement — Display Options​

Setting	What It Does
Button Text	Custom button label (when shown)
Show Button	Toggle the optional advance button (conversational form)

Section — Layout Options​

Setting	What It Does
Section Title	The heading text
Description	Caption beneath the title
Collapsible	When on, lets the visitor collapse/expand the section

Spacer / Page Break / Button​

Field	Settings
Spacer	Height (px)
Page Break	Step Label (text shown beside the step indicator)
Button	Text, Action (submit / url / next_page), URL (when action=url)

Hidden — Default Value Only​

The Hidden field has only the Default Value field. Use it to attach a fixed value (or — more commonly — pair it with a URL parameter via hidden fields & variables).

---

Next Steps​

• Validation — Per-field validation rules
• Conditional Logic — Show/hide based on other fields
• Style & Design — Width, label position, alignment
• Field Types Reference — Catalog of all 48 fields