Form Fields Overview

Buildorado provides 33 purpose-built field types that cover every data collection scenario, from simple text inputs to embedded payment processing. Each field type comes with tailored configuration options, validation rules, and appearance controls accessible through the inspector panel.

This section provides a detailed reference for every field type. Fields are organized into the same categories you see in the builder sidebar.

Adding Fields to Your Form

There are two ways to add fields in the form builder:

1. Drag and drop -- Open the Fields tab in the left sidebar. Browse the field categories, then drag any field type onto the canvas and drop it where you want it to appear.
2. Click to add -- Click any field type in the sidebar palette. The field is appended to the end of the current form step.

Once a field is on the canvas, click it to open the inspector panel on the right side of the screen. The inspector is where you configure every aspect of the field: its label, validation rules, appearance, help text, and behavior.

Field Categories

Fields are organized into six groups in the sidebar. Each group serves a distinct purpose in your form design.

Input Fields

The foundational text and numeric fields used in almost every form. These fields accept direct user input with built-in format validation.

Selection Fields

Let users choose from predefined options. Use these when you want structured, consistent responses rather than free-text entry.

Date and Time Fields

Purpose-built inputs for temporal data with native pickers for a smooth user experience across desktop and mobile.

File and Signature Fields

Specialized input fields for capturing files and handwritten signatures.

Content and Display Fields

Display-only fields that do not collect user data. They enhance the form experience with rich media, pricing information, and structured content.

Action Fields

Fields that trigger actions or provide interactive navigation elements.

Integration Fields

Special fields that embed third-party services directly inside your form flow.

Common Properties

Every field in Buildorado shares a set of base properties that you configure in the inspector panel. These properties are available regardless of field type.

Label and Help Text

• Label -- The visible text displayed above the field. Keep labels concise and descriptive. For example, "Company Name" is better than "Please enter the name of your company."
• Help Text -- A smaller line of text displayed below the field. Use it for supplementary instructions or format hints. For example, "Enter the name as it appears on your business license."
• Note -- An additional informational note associated with the field. Displayed as a tooltip or inline annotation depending on the theme.
• Placeholder -- Ghost text inside the input that disappears when the user starts typing. Use for format examples like "[email protected]" rather than as a substitute for the label.

Field Key

The key is the variable name used to reference the field's value in conditional logic, workflow variables, and API responses. Keys are auto-generated from the label (for example, "First Name" becomes first_name) and can be customized. Keys must be unique within a form step.

Required Toggle

Mark a field as required to prevent form submission until the user provides a value. Required fields display a red asterisk next to the label and show a validation error if left empty.

Width

Control the horizontal space a field occupies in the form layout:

On mobile devices, all fields automatically stack to full width regardless of this setting.

Visual Styling

Each field offers granular appearance controls:

These styling options let you create visual hierarchy within your form. For example, you might use a stronger border and subtle shadow on a payment field to draw attention to it, while keeping standard text inputs minimal with no border and transparent background.

Error Message

Override the default validation error message with custom text. Instead of the generic "This field is required," you can write something specific like "Please enter your email address so we can send your receipt."

On-Complete Behavior

Control what happens when the user finishes interacting with a field:

This is particularly useful for single-choice fields like radio buttons or select dropdowns, where selecting an option can automatically advance the user to the next step.

Input Field Validations

Fields that extend the input field base (text, textarea, number, email, phone, range, and all selection fields) have additional validation options:

• Min / Max -- For numeric fields, define the acceptable value range.
• Min Length / Max Length -- For text fields, set character count limits.
• Pattern -- A regular expression that the input must match. For example, ^[A-Z]{2}\\d{6}$ to validate a license number format.
• Pattern Message -- A custom error message shown when the pattern validation fails.

Options Configuration

Fields that present choices to the user (select, radio, checkbox, icon select) share an options editor in the inspector. Each option has:

Options can be reordered by dragging, added with the "Add Option" button, and deleted individually.

Next Steps

Dive into the detailed documentation for each field type. Browse by category in the sidebar, or jump directly to a specific field:

• Input -- Text, Textarea, Number, Email, Phone, Range
• Selection -- Select, Radio, Checkbox, Toggle, Rating, Country Select, Currency Select, Icon Select
• Date and Time -- Date