Core Field Types
Formcierge ships with 30+ field types grouped into four categories.
General Fields
| Field |
Type slug |
Description |
| Text |
text |
Single-line text input. Supports min/max length and regex validation. |
| Textarea |
textarea |
Multi-line text. Configurable rows and character limit. |
| Email |
email |
Email address with built-in format validation. |
| Number |
number |
Numeric input with min, max, and step controls. |
| Select |
select |
Dropdown with static or dynamic option source. |
| Radio |
radio |
Mutually exclusive choice list. |
| Checkbox Group |
checkbox-group |
Multiple-selection checkbox list. |
| Row |
row |
Layout container — splits the canvas into 2–4 equal columns. |
Advanced Fields
| Field |
Type slug |
Notes |
| Tel |
tel |
Phone number. Can be combined with Masked Input for formatting. |
| Date Picker |
date |
Date selector with min/max date range. |
| Booking Calendar |
calendar |
Full appointment calendar. Requires the Booking Calendar addon. |
| Time |
time |
Time picker (HH:MM). |
| File Upload |
file |
Single file. Configure allowed MIME types and max size. |
| Multi File Upload |
file-multi |
Multiple files in one field. |
| Country |
country |
ISO 3166-1 country dropdown. |
| State / Province |
state |
Populates based on selected country. |
| Address |
address |
Composite field: street, city, state, postcode, country. |
| Rating |
rating |
Star rating 1–10 with custom icon and colour. |
| Range |
range |
Slider with configurable min, max, step, and label. |
Layout Fields
| Field |
Type slug |
Notes |
| Heading |
heading |
H1–H4 heading for grouping sections visually. |
| Paragraph / HTML |
html |
Rich text block. Supports inline HTML. |
| Divider |
divider |
Horizontal rule between field groups. |
Specialised Fields
| Field |
Type slug |
Notes |
| Hidden |
hidden |
Not shown to users. Submits a fixed or dynamic value. |
| Honeypot |
honeypot |
Invisible anti-spam field. If filled by bots, the submission is rejected. |
| Consent |
consent |
Required checkbox for GDPR or terms acceptance. |
| Signature |
signature |
Canvas-based freehand signature, exported as PNG on submit. |
| Masked Input |
masked |
Format mask (phone, credit card, custom) for any text input. |
| Dynamic Source |
dynamic_source |
Populates options from a REST endpoint or WP taxonomy. |
Common Field Settings
All fields share these base settings:
- Label — displayed above the field
- Placeholder — greyed-out hint inside the input
- Required — if enabled, blocks submission when empty
- Help text — shown below the field
- Width — 25%, 33%, 50%, 66%, 75%, or 100% of the column
- Hide label — hides the label but keeps it for screen readers
- Icon — optional icon inside the input (left or right)