Form Builder Fields
Every field in your form can be configured directly in the builder. Click on a field to open its settings.
Field categories
| Category | Fields |
|---|---|
| Basic | Text, text area, email, phone, number, date, time, checkbox, radio, dropdown, picture choice |
| Contact | Salutation, first name, last name, company, phone, mobile, email |
| Address | Street, postal code, city, address line 2, address line 3, country |
| Event | Event title, date, end date, start time, end time, attendees, days, contact, people min, people max |
| Advanced | File upload, rating, products, rooms, custom data, cart summary, privacy/terms |
| Design | Heading, text block, rich text, alert, separator, spacer, image, summary details, assignee block |
| Blocks | Event block (adds a predefined set of event-related fields such as event name, date, location, and more in one action) |
Common field properties
Every field in the builder shares a set of common properties. These are available on all data-collecting field types (basic, contact, address, event, and advanced fields).
| Property | Type | Default | Description |
|---|---|---|---|
| Label | text | field-type name | The visible label shown above the field. |
| Label Icon | text | -- | Icon name (Lucide icon set) or emoji displayed next to the label. |
| Hide Label | on/off | off | Hides the label in the rendered form. The label is still used internally. |
| Placeholder | text | -- | Hint text shown inside the empty field (where the field supports it). |
| Help Text | text | -- | Explanatory text shown below the field. |
| Required | on/off | off | The field must be filled in before the form can be submitted. |
| Read only | on/off | off | The field is visible but cannot be edited by the user. |
| Field Visibility | visible / hidden / conditional | conditional | Visible -- always shown. Hidden -- never shown (can have a fixed value that is always submitted). Conditional -- controlled by conditional logic rules; if no rules target this field, it is always visible. |
| Custom API Field Name | text | -- | Your own API field name for external system mapping (lowercase letters, numbers, underscores, and dots). |
| Lock Behavior | policy | -- | Controls when this field becomes immutable (detail forms only). See Lock Policies. |
Fields that cannot be locked: heading, text block, alert, separator, spacer, image, rich text, custom data, cart summary, assignee block, summary details.
Settings available on most fields
Basic settings
- Label and optional hidden label.
- Label icon (pick an icon name or use an emoji).
- Placeholder (where the field supports it).
- Help text -- shown below the field.
- Default value.
- Required -- the field must be filled in.
- Read only -- the field is visible but cannot be edited.
Advanced settings
- API field name -- the technical name used in submissions. Use this name when connecting to external systems via API or webhooks.
- Custom API field name -- set your own name (lowercase letters, numbers, underscores, and dots).
- Visibility mode:
- Visible -- always shown.
- Hidden -- never shown (can have a fixed value).
- Conditional (default) -- controlled by conditional logic rules. If no conditional logic rules target this field, it is always visible.
- Lock policy (detail forms only, for fields that support locking) -- see Lock Policies in the Builder Basics page.
Fields that cannot be locked: heading, text block, alert, separator, spacer, image, rich text, custom data, cart summary, assignee block, summary details.
Field type reference
Basic fields
Text
Single-line text input.
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | 0 | Minimum number of characters required. |
| Maximum Length | number | 255 | Maximum number of characters allowed. |
| Suggestions | list | -- | Predefined autocomplete suggestions the user can pick from. Each suggestion has a value and an optional display label. |
Text area
Multi-line text input.
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. Uses the shared text config panel. |
| Maximum Length | number | -- | Maximum number of characters allowed. Uses the shared text config panel. |
| Rows | number (1--20) | 4 | Number of visible text rows (controls the height of the field). |
Email
Email address input with automatic format validation.
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
The contact email variant maps directly to the contact email field in form submissions.
Phone
Phone number input.
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Number
Number input with an optional slider mode.
| Config option | Type | Default | Description |
|---|---|---|---|
| Integer only | on/off | off | Whole numbers only -- restricts the field to integers. When turned on, step is locked to 1. |
| Display Mode | Input field / Slider | Input field | Input field -- standard number input. Slider -- a visual slider control. Slider mode requires a maximum value to be set. |
| Minimum | number | -- | Minimum value allowed. |
| Maximum | number | -- | Maximum value allowed. Must be set to enable slider mode. |
| Step Size | number | -- | Increment/decrement step size. Locked to 1 when integer mode is on. Supports decimal steps (e.g. 0.5) otherwise. |
Date
Date picker with optional restrictions.
| Config option | Type | Default | Description |
|---|---|---|---|
| No past dates | on/off | on for event date, off otherwise | Blocks yesterday and earlier. Today is always allowed. |
| Earliest Date | date | -- | Absolute earliest selectable date. |
| Latest Date | date | -- | Absolute latest selectable date. |
| Minimum days from today | number | 0 | Minimum advance notice -- earliest selectable date expressed as days from today. |
| Maximum days from today | number | 9999 | Maximum booking window -- latest selectable date expressed as days from today. |
| Count business days only | on/off | off | When on, weekends (Saturday/Sunday) are skipped in the day count for advance notice. |
| Allowed Weekdays | list of days | -- | Restricts selection to specific days of the week (0 = Sunday ... 6 = Saturday). Only used in weekday restriction mode. |
| Date Availability | object | -- | Controls date restriction by specific dates or external API. See sub-options below. |
Date availability sub-options (only one restriction mode can be active):
| Sub-option | Type | Default | Description |
|---|---|---|---|
| Mode | Allow only these dates / Block these dates | Block these dates | Allow only these dates (allow-list) -- only listed dates are selectable. Block these dates (block-list) -- listed dates are blocked. |
| Source | External API / Manual entry | -- | External API -- dates come from an external data source. Manual entry -- dates are entered manually. |
| API Availability | Data source name | -- | Select the external data source integration (API mode). |
| Specific dates | list of dates | [] | Manually entered dates (static mode). |
| Cache Duration | number | -- | How long API responses are cached, in minutes (API mode). |
The minimum advance notice is adjusted automatically so it never exceeds the maximum booking window.
Default behavior:
- Event date fields start with "no past dates" turned on.
- Regular date fields and event end date fields do not.
Time
Time picker.
| Config option | Type | Default | Description |
|---|---|---|---|
| Time Format | 24-Hour Format / 12-Hour Format | 24-Hour Format | 24-Hour Format (14:30) or 12-Hour Format (2:30 PM). |
| Earliest Time | time | -- | Earliest selectable time. |
| Latest Time | time | -- | Latest selectable time. |
| Minute Steps | 1 / 5 / 15 / 30 | 1 | Minute interval for time selection. |
Checkbox
A checkbox field with three possible modes:
Single checkbox (default) -- a simple yes/no toggle.
- Default state: checked or unchecked.
Multiple selection -- turn on Allow multiple to show a list of checkboxes.
- Add, edit, and reorder options.
- Multiple options can be pre-selected.
Single selection -- turn on both Allow multiple and Single selection to show options where only one can be picked.
- Works like radio buttons but displayed as checkboxes.
| Config option | Type | Default | Description |
|---|---|---|---|
| Allow multiple selections | on/off | off | Shows a list of checkbox options instead of a single checkbox. |
| Single Selection Mode | on/off | off | Only available when Allow multiple selections is on. Limits selection to one option (radio-button behavior with checkbox visuals). |
| Checked by default | on/off | off | Default state of a single checkbox (only when Allow multiple selections is off). |
| Options | list | [] | The list of options (only when Allow multiple selections is on). Each option has an ID, a value, and a label. Options can be reordered with drag and drop. |
| Pre-selected options | list | [] | Pre-selected option values (multiple selection mode). |
| Default Value | text | -- | Pre-selected option value (single selection mode). |
Radio buttons
A group of options where only one can be selected.
| Config option | Type | Default | Description |
|---|---|---|---|
| Options | list | [] | The list of options. Each option has an ID, a value, and a label. Options can be reordered with drag and drop. |
| Default Value | text | -- | The option value that is selected by default. |
Dropdown
A dropdown selection field.
| Config option | Type | Default | Description |
|---|---|---|---|
| Options | list | [] | The list of options. Each option has an ID, a value, and a label. Options can be reordered with drag and drop. |
| Allow multiple selections | on/off | off | Allow multiple selections -- lets users pick more than one value. |
Picture choice
Image-based selection. Users pick from visual options.
| Config option | Type | Default | Description |
|---|---|---|---|
| Options | list | [] | The list of options. Each option has an image, a label, and a value. Options can be reordered with drag and drop. |
| Single Selection Mode | on/off | off | Only one image can be picked. Turn off to allow multiple selections. |
| Hide Labels | on/off | off | Show images only, without text labels. |
| Columns per Row | Auto / 2 / 3 / 4 / 5 / 6 | Auto | Number of columns per row. Auto adjusts responsively. |
| Default Value | text | -- | Pre-selected option value (single selection mode). |
| Pre-selected options | list | [] | Pre-selected option values (multiple selection mode). |
Contact fields
When a customer fills in contact fields, Eventyflow automatically links the submission to their contact record. This means you do not need to create contacts manually.
All contact fields use the text field config panel (min/max length). The table below shows the specific config for each contact field type.
Salutation
Salutation or title input.
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
| Suggestions | list | Mr, Mrs | Predefined autocomplete suggestions the user can pick from. You can add, remove, and reorder suggestions. |
First name
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
| Required | on/off | on | Required by default (unlike most other fields). |
Last name
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
| Required | on/off | on | Required by default (unlike most other fields). |
Company
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Phone (contact)
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Mobile
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Email (contact)
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
The contact email field maps directly to the contact's email address in the CRM. It has automatic email format validation.
Address fields
All address fields except country use the text field config panel (min/max length). The table below shows the specific config for each address field type.
Street
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Postal code
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
City
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Address line 2
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Address line 3
| Config option | Type | Default | Description |
|---|---|---|---|
| Minimum Length | number | -- | Minimum number of characters required. |
| Maximum Length | number | -- | Maximum number of characters allowed. |
Country
Country selection with autocomplete.
| Config option | Type | Default | Description |
|---|---|---|---|
| Maximum Length | number | -- | Maximum number of characters allowed. |
| Suggestions | list | -- | Predefined country suggestions the user can pick from. You can add, remove, and reorder suggestions. Each suggestion is shown as a dropdown option. |
Unlike other address fields, the country field has its own config panel with a suggestions manager for the country list. It does not have a minimum length setting.
Event fields
These fields are specific to event forms. Each event field can only appear once per form.
Event title
The event name. Cannot be deleted from the form.
- Min/max length.
- Autocomplete suggestions.
Event date
The event start date. Cannot be deleted from the form.
- Same settings as the date field.
- Starts with "no past dates" turned on.
Event end date
- Same settings as the date field.
Event start time
- Same settings as the time field.
Event end time
- Same settings as the time field.
Attendees
Expected number of attendees.
- Number input with optional slider mode.
- Min/max value.
Event days
Event duration in days.
- Number settings.
Event contact
Contact person for the event.
- Min/max length.
People min
Minimum number of people.
- Number settings.
People max
Maximum number of people.
- Number settings.
Advanced fields
File upload
Let users upload files.
- Allowed file types (filter by type).
- Max file size (1--25 MB, whole numbers only).
- Allow multiple files.
This field is only available when file upload is enabled in your workspace settings.
Rating
A rating input with different display styles.
| Config option | Type | Default | Description |
|---|---|---|---|
| Display Mode | Stars / Scale Bar / Numbers / Emoji | Stars | Stars -- star icons. Scale Bar -- a horizontal scale bar. Numbers -- number buttons. Emoji -- emoji icons (limited to max 5). |
| Maximum Rating | number (1--10) | 5 | The highest value on the rating scale. In emoji mode, automatically capped at 5. |
| Size | Small / Medium / Large | Medium | Visual size of the rating elements. |
| Star Color | hex color | theme color | Custom color for the star icons (only applies in stars mode). Example: #fbbf24. |
| Min Label | text | -- | Optional label displayed below the lowest rating value (e.g. "Poor"). |
| Max Label | text | -- | Optional label displayed below the highest rating value (e.g. "Excellent"). |
In emoji mode, the maximum rating is always 5.
Products
Product selection and pricing field. See Form Builder Products and Rooms for the full setup guide.
Rooms
Room booking and pricing field. See Form Builder Products and Rooms for the full setup guide.
Custom data
A hidden data field for system integrations. Not visible to form users.
- Data path.
- Key/value entries.
- JSON preview.
Always included in submissions. Cannot be locked.
Cart summary
Shows a shopping cart overview. Can only appear once per form.
- Automatically links to product and room fields in the same form.
- Displays items, quantities, subtotals, tax, and the grand total.
Privacy/terms
A consent checkbox for privacy policy and terms. Can only appear once per form.
- Consent text (supports rich text with links).
- Dynamic link placeholders for linking to your privacy policy and terms pages (e.g.
{{privacy_url}},{{terms_url}}). - Always required -- users must accept before submitting.
Design fields
Design fields add visual structure. They do not collect any data and are skipped during validation.
Heading
A section heading.
- Text content.
- Heading level (1--6).
- Alignment: left, center, right, or justified.
- Custom color.
Text block
A static text paragraph.
- Text content.
- Alignment: left, center, right, or justified.
- Font size: small, medium, or large.
- Custom color.
Rich text
A formatted text editor with a toolbar.
- Supports bold, italic, underline, headings, lists, links, and text alignment.
Alert
A colored notice box.
- Message content.
- Type:
- Info (blue).
- Success (green).
- Warning (yellow/orange).
- Error (red).
- Show icon toggle.
Separator
A divider line.
- Style: solid, dashed, or dotted.
- Thickness (1--5 pixels).
- Vertical spacing.
- Custom color.
Spacer
Empty vertical space.
- Height: choose a preset size or enter a custom pixel value.
Image
Display an image.
- Image source (file or URL).
- Alt text.
- Width: auto (original), full (100%), half (50%), third (33%), quarter (25%), or a fixed pixel width (200--500 px).
- Alignment: left, center, or right.
Summary details
A read-only overview of all submitted field values. Automatically placed in the summary step.
- Cannot be deleted, duplicated, or moved.
- Does not support conditional logic.
Assignee block
Shows information about the assigned person. Only available in detail forms.
Visible fields (toggle each on/off):
- Avatar, name, function/role, tagline, email, phone, mobile.
Layout:
- Avatar size: small, medium, large, extra large.
- Layout direction: horizontal or vertical.
- Content columns: 1, 2, or 3.
- Column alignment: spread, left, center, or right.
- Vertical alignment per column: top, center, or bottom.
- Reorder fields with drag and drop and assign them to columns.
Does not support conditional logic. Shows live data from the assigned user's profile.
Dynamic values in design fields
In detail forms, design fields (heading, text block, alert, rich text) and the assignee block can display dynamic values. These are replaced with actual event or response data when the form is shown. Example placeholders: {{event.name}}, {{contact.name}}, {{workspace.name}}.
Placement rules
Fields that can only appear once
Event title, event date, event end date, event start time, event end time, attendees, event days, event contact, people min, people max, rooms, cart summary, privacy/terms, and summary details.
Fields that cannot be deleted
- Event title and event date -- always required in event forms. Cannot be deleted, duplicated, or hidden.
- Summary details -- cannot be deleted, duplicated, or moved.
Step restrictions
- Success step: only design fields are allowed.
- Summary step: only heading, text block, separator, spacer, alert, image, rich text, checkbox, privacy/terms, text, and text area. Blocks cannot be added. Summary details is placed automatically.
Form type restrictions
- Event fields and the event block are only available in event forms.
- Detail forms can use event fields only when event updates are enabled for that form.
- The assignee block is only available in detail forms.
Feature restrictions
- The file upload field is only available when file upload is enabled in your workspace.