Field Types
FilaForms ships with 25 field types covering text, numbers, dates, choices, files, and advanced use cases. Each field type defines its own data type, validation rules, and table capabilities.
Summary
| Type | Key | Data Type | Searchable | Sortable | Filterable |
|---|---|---|---|---|---|
| Text | text | Text | Yes | Yes | No |
email | String | Yes | Yes | No | |
| Textarea | textarea | Text | Yes | Yes | No |
| Rich Editor | rich-editor | Text | Yes | Yes | No |
| Markdown Editor | markdown-editor | Text | Yes | Yes | No |
| Phone | phone | String | Yes | Yes | No |
| Link | link | String | Yes | Yes | No |
| Number | number | Numeric | Yes | Yes | No |
| Currency | currency | Float | Yes | Yes | No |
| Date | date | Date | Yes | Yes | No |
| Date Time | date-time | DateTime | Yes | Yes | No |
| Select | select | Single Choice | Yes | Yes | Yes |
| Radio | radio | Single Choice | Yes | Yes | Yes |
| Toggle Buttons | toggle-buttons | Single Choice | Yes | Yes | Yes |
| Checkbox List | checkbox-list | Multi Choice | Yes | Yes | Yes |
| Multi Select | multi-select | Multi Choice | Yes | Yes | Yes |
| Tags Input | tags-input | Multi Choice | Yes | Yes | No |
| Checkbox | checkbox | Boolean | Yes | Yes | No |
| Toggle | toggle | Boolean | Yes | Yes | No |
| File Upload | file-upload | String | Yes | Yes | No |
| Signature | signature | Text | No | No | No |
| Section Divider | section-divider | Text | Yes | Yes | No |
| Color Picker | color-picker | Text | Yes | Yes | No |
| Line Items | line-items | Multi Choice | No | No | No |
Text Fields
Text
Single-line text input. The most common field type.
Validation Rules: Required, Min, Max, Alpha, AlphaNum, AlphaDash, Email, StartsWith, EndsWith.
Email address input with built-in email validation applied by default.
Additional Validation Rules: Required, Min, Max.
Textarea
Multi-line text input for longer responses.
Validation Rules: Required, Min, Max.
Rich Editor
WYSIWYG editor with formatting toolbar (bold, italic, lists, links, etc.).
Validation Rules: Required, Min, Max.
Markdown Editor
Markdown input with preview support.
Validation Rules: Required, Min, Max.
Phone
Phone number input field.
Validation Rules: Required, Min, Max, Regex, StartsWith.
Link
URL input with built-in url validation applied by default.
Additional Validation Rules: Required, URL, StartsWith, Min, Max.
Number Fields
Number
Integer or decimal number input.
Validation Rules: Required, Numeric, Integer, Min, Max, Between.
Currency
Decimal currency input with $ prefix.
Validation Rules: Required, Numeric, Decimal, Min, Max, Between.
Date & Time Fields
Date
Date picker for selecting a single date.
Validation Rules: Required, After, AfterOrEqual, Before, BeforeOrEqual.
Date Time
Combined date and time picker.
Validation Rules: Required, After, AfterOrEqual, Before, BeforeOrEqual.
Choice Fields (Single)
These fields store a single selected value. Define options as label-value pairs in the builder.
Select
Dropdown select menu.
Validation Rules: Required, In, NotIn.
Radio
Radio button group. All options visible at once.
Validation Rules: Required, In, NotIn.
Toggle Buttons
Button group where one option can be selected. Visual alternative to radio buttons.
Validation Rules: Required, In, NotIn.
Choice Fields (Multiple)
These fields store an array of selected values.
Checkbox List
Multiple checkboxes rendered as a vertical list.
Validation Rules: Required, Min, Max.
Multi Select
Multi-select dropdown. Respondents can pick multiple options from the list.
Validation Rules: Required, Min, Max.
Tags Input
Comma-separated tag input. Respondents can type and create new values on the fly.
Validation Rules: Required, Min, Max.
Boolean Fields
Checkbox
Single checkbox for yes/no or agree/disagree inputs.
Validation Rules: Required, Boolean.
Toggle
Toggle switch. Functionally identical to Checkbox with a different visual style.
Validation Rules: Required, Boolean.
File & Media Fields
File Upload
Upload one or more files. Files are stored on the configured disk with ULID filenames.
Default Validation: File (always applied).
Additional Validation Rules: Required, Mimes, Max.
config/filaforms.php under the storage key. See Configuration.Signature
Digital signature pad. Captures a drawn signature and stores it as an image file (PNG, JPEG, or WebP). Maximum file size is 512 KB.
Validation Rules: Required.
Layout Fields
Section Divider
Visual separator with optional text. Use the placeholder field to set the divider text. No data is collected -- this field is purely decorative.
Validation Rules: None.
Advanced Fields
Color Picker
Color selection input.
Validation Rules: Required, StartsWith.
Line Items
Repeater field for structured row data -- invoices, orders, attendee lists, and similar master-detail patterns.
Validation Rules: Required, Array, Min, Max.
Templates
Line Items ships with pre-built templates:
| Template | Fields |
|---|---|
| Invoice Items | Description, Qty, Unit Price, Total (auto-calculated) |
| Order Items | Product, SKU, Quantity, Unit Price, Total (auto-calculated) |
| Expense Items | Category (select), Description, Amount, Date |
| Attendees | Full Name, Email, Phone, Meal Preference (select) |
| Shipping Items | Item, Weight, Dimensions, Declared Value |
| Custom | Define your own nested fields |
Configuration Options
| Option | Default | Description |
|---|---|---|
| Template | invoice_items | Pre-built field layout |
| Min Items | 1 | Minimum number of rows |
| Max Items | 25 | Maximum number of rows |
| Reorder | true | Allow drag-and-drop row reordering |
Business templates (Invoice Items, Order Items) use a table layout and auto-calculate totals from quantity and unit price fields.