Fields
No matter if you use presets or create your own layouts, form fields are an essential part of the configuration and have very powerful options.
Available form fields
Checkboxes
A list of checkbox fields
Date
A date picker field
An email input field with validation
Files
A files select field that allows to select one or multiple related files
Headline
Creates a headline to group fields
Hidden
Creates a hidden field
Info
A plain HTML field for user instructions
Line
Draws a horizontal line to separate fields
Multiselect
A select field that allows you to select multiple options
Number
A number input field with validation
Pages
A pages select field that allows to select one or multiple related pages
Radio
A list of radio buttons
Range
A handy slider
Select
A simple selectbox field
Structure
Structured data input, which stores data in a field as YAML.
Tags
An interactive tags input field with autocompletion
Tel
A phone number input field
Text
A standard, single-line input field
Textarea
A textarea field, which auto-resizes and has built-in format buttons.
Time
A time picker field
Toggle
Yes/no or on/off toggle
Url
A URL input field with validation
Users
A user select field that allows to select one or multiple users
Custom fields
You can extend this list with your own field types by creating a field plugin.
Naming fields
You can choose the names for your fields freely, but there are two limitations:
- You can only use alphanumeric characters and underscores in field names.
- If you use field names that are reserved by native Kirby methods, your field names will conflict. For example, if you give your field the name "image", it will conflict with Kirby's
$page->image()method. You can still use this field name, but you will have to call such a field via the$page->content()->image()method. We recommend prefixing your field names instead.