Advanced Fields Reference
Advanced fields handle file uploads, commerce, ratings, data integration, and legal consent. Some of these fields are unique per form or require specific workspace settings to be enabled.
File Upload
Let users upload one or more files with your form submission.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "File Upload" | The field label shown to users |
| Required | on/off | off | Whether at least one file must be uploaded |
| Allowed File Types | string | (all types) | Comma-separated list of allowed file extensions (e.g. pdf,doc,docx) |
| Maximum File Size (MB) | number | 5 | Maximum file size in MB (minimum: 0.1, step: 0.1) |
Validation
- When Required is on, at least one file must be uploaded.
- If Allowed File Types is set, only files with matching extensions are accepted.
- Each file must be within the Maximum File Size (MB) limit.
Restrictions
| Property | Value |
|---|---|
| Unique per form | No |
| Deletable | Yes |
| Duplicatable | Yes |
| Movable | Yes |
This field is only available in detail forms. It does not appear in registration or event forms.
Files uploaded through detail forms are automatically deleted 60 days after the event end date.
Conditional logic operators
Operator group: text
| Operator | Description |
|---|---|
| Equals | Value matches exactly |
| Does not equal | Value does not match |
| Contains | Value contains the text |
| Does not contain | Value does not contain the text |
| Starts with | Value starts with the text |
| Ends with | Value ends with the text |
| Is empty | No file uploaded |
| Is not empty | At least one file uploaded |
Products
Product selection and pricing field. Allows users to choose products and quantities. For the full setup guide, see Form Builder Products.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Products" | The field label shown to users |
| Required | on/off | off | Whether at least one product must be selected |
| Product Source | Manual / Catalog list | Manual | How products are sourced |
| Price Display | Net / Gross / Both | Gross | How prices are displayed |
| Show Tax Information | on/off | on | Show tax information alongside prices |
| Allow Multiple Selection | on/off | on | Allow selecting more than one product |
| Layout Type | Grid / List | Grid | Product display layout |
Restrictions
| Property | Value |
|---|---|
| Unique per form | No |
| Deletable | Yes |
| Duplicatable | Yes |
| Movable | Yes |
Conditional logic operators
Operator group: text
Rooms
Room booking and pricing field. Allows users to select rooms, optionally with layouts and availability checking. For the full setup guide, see Form Builder Rooms.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Rooms" | The field label shown to users |
| Required | on/off | off | Whether at least one room must be selected |
| Room Source | Manual / Catalog list | Manual | How rooms are sourced |
| Allow Multiple Room Selection | on/off | off | Allow selecting more than one room |
| Show Room Prices | on/off | on | Show room prices |
| Display Layout | Grid / List | Grid | Room display layout |
| Columns (Grid View) | number | 2 | Number of columns in grid layout (1--4) |
| Show Filter Options | on/off | on | Show filter controls (capacity, equipment) |
| Filter by Capacity | on/off | on | Enable capacity filter |
| Filter by Equipment | on/off | on | Enable equipment filter |
| Filter by Availability | on/off | off | Enable availability filter |
| Availability Source | None / External API | None | Availability data source type |
Restrictions
| Property | Value |
|---|---|
| Unique per form | Yes |
| Deletable | Yes |
| Duplicatable | No |
| Movable | Yes |
Conditional logic operators
Operator group: text
Cart Summary
A read-only summary showing all selected products and rooms, their quantities, prices, tax, and the grand total. This is a display-only field -- it does not collect its own data.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Cart Summary" | The field label shown to users |
| Required | on/off | off | Not applicable for display-only fields |
No additional configuration options are available. The cart summary automatically links to product and room fields in the same form.
Restrictions
| Property | Value |
|---|---|
| Unique per form | Yes |
| Deletable | Yes |
| Duplicatable | No |
| Movable | Yes |
Conditional logic operators
Operator group: text
Privacy & Terms
A consent checkbox for privacy policy and terms of service. Used to collect legally required consent before form submission.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Privacy & Terms" | The field label shown to users |
| Required | on/off | on | Always required -- cannot be made optional |
| Checkbox Text Template | string | (default template) | The consent text with link placeholders, e.g. "I agree to the {privacy}" |
| Links Configuration | array | 1 default link | List of links, each with a display text and URL |
Validation
- Always required. Users must check the consent box before submitting.
- The consent text must be provided.
Restrictions
| Property | Value |
|---|---|
| Unique per form | Yes |
| Deletable | Yes |
| Duplicatable | No |
| Movable | Yes |
Conditional logic operators
Operator group: checkbox
| Operator | Description |
|---|---|
| Checked | Consent box is checked |
| Unchecked | Consent box is unchecked |
Custom Data
A hidden field for storing key/value data that is always included in form submissions. It is not visible to form users and is intended for system integrations and API workflows.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Custom Data" | Internal label (not shown to users) |
| Data Path | string | "" | A data path identifier for integration mapping |
| Data Entries | array | (empty) | Key/value pairs stored with the submission |
| Field Visibility | string | Always Hidden | Always hidden from users |
Validation
- No user-facing validation. The field is always hidden and always submitted.
Restrictions
| Property | Value |
|---|---|
| Unique per form | No |
| Deletable | Yes |
| Duplicatable | Yes |
| Movable | Yes |
Conditional logic operators
Operator group: text
Rating
A rating input with multiple display styles.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Rating" | The field label shown to users |
| Required | on/off | off | Whether a rating must be given |
| Maximum Rating | number | 5 | Maximum rating value (1--10) |
| Display Mode | Stars / Scale Bar / Numbers / Emoji | Stars | How the rating is displayed |
| Size | Small / Medium / Large | Medium | Size of the rating element |
| Min Label | string | (empty) | Label below the lowest value (e.g. "Poor") |
| Max Label | string | (empty) | Label below the highest value (e.g. "Excellent") |
Display modes
| Mode | Description |
|---|---|
| Stars | Star icons that fill on hover/click |
| Scale Bar | A horizontal scale bar |
| Numbers | Clickable number buttons |
| Emoji (max 5) | Emoji icons (maximum rating is always capped at 5) |
Validation
- When Required is on, a rating value must be selected.
- Value must be between 1 and the Maximum Rating.
Restrictions
| Property | Value |
|---|---|
| Unique per form | No |
| Deletable | Yes |
| Duplicatable | Yes |
| Movable | Yes |
Conditional logic operators
Operator group: number
| Operator | Description |
|---|---|
| Equals | Rating matches exactly |
| Does not equal | Rating does not match |
| Greater than | Rating is greater than the value |
| Less than | Rating is less than the value |
| Greater than or equal | Rating is greater than or equal to the value |
| Less than or equal | Rating is less than or equal to the value |
| Is empty | No rating given |
| Is not empty | A rating has been given |
Image (Advanced Upload)
An image upload field that lets users upload an image file as part of their submission.
Config options
| Option | Type | Default | Effect |
|---|---|---|---|
| Label | string | "Image" | The field label shown to users |
| Required | on/off | off | Whether an image must be uploaded |
| Maximum File Size (MB) | number | 5 | Maximum file size in MB (minimum: 0.1, step: 0.1) |
Validation
- When Required is on, an image must be uploaded.
- File size must be within the Maximum File Size (MB) limit.
Restrictions
| Property | Value |
|---|---|
| Unique per form | No |
| Deletable | Yes |
| Duplicatable | Yes |
| Movable | Yes |
Conditional logic operators
Operator group: text
This is the advanced image upload field. For the design image field that displays a static image in the form layout, see Design Fields Reference.
Common base options
All advanced fields also support the following base options (see Form Builder Fields for details):
| Option | Description |
|---|---|
| Label | The field label displayed to users |
| Label Icon | An icon name or emoji shown next to the label |
| Placeholder | Placeholder text inside the field (where supported) |
| Help Text | Help text displayed below the field |
| Required | Whether the field must be filled in |
| Read only | The field is visible but cannot be edited |
| Field Visibility | Always Visible / Always Hidden / Conditional |
| Hide Label | Hides the field label in the rendered form |
| Custom API Field Name | Custom technical name for API/webhook mapping |
| Lock Behavior | Controls when the field becomes immutable (detail forms only) |
Related
- Form Builder Fields -- overview of all field types
- Form Builder Products -- full products setup guide
- Form Builder Rooms -- full rooms setup guide
- Form Builder Conditional Logic