Field Types & Settings

The below article details the available Field Types in Maica Forms, and the associated Settings

Field Types

Maica Forms supports a wide range of field types. These are grouped into categories and detailed below.

Category	Field Type	Description
Text and Input	Text	A single-line text input for names, short answers, reference numbers, or any free-text response that fits on one line.
Text and Input	Long Text	A multi-line text area for comments, notes, descriptions, or anything that needs more space.
Text and Input	Email	A single-line input that validates email format. Use whenever you need an email address from the respondent.
Text and Input	Number	A numeric input with optional minimum and maximum values, integer-only mode, and maximum decimal places.
Text and Input	Phone	A single-line input for phone numbers, with optional pattern validation (e.g. Australian mobile format).
Text and Input	URL	A single-line input for web addresses, with an optional HTTPS-only setting.
Text and Input	Currency	A numeric input pre-formatted with a currency symbol. Use for fee amounts, quotes, or financial data.
Date and Time	Date	A date picker with optional range restrictions using fixed dates or relative values like today or tomorrow, and an optional weekdays-only setting.
Date and Time	Time	A time picker for hours and minutes.
Date and Time	Date & Time	A combined date and time picker in a single field.
Choice	Dropdown (Select)	A single-choice dropdown list. Good for long option lists.
Choice	Multi-Select	A dropdown that allows respondents to choose multiple options.
Choice	Radio Group	A set of radio buttons displayed vertically or horizontally. Best for 2-6 options where you want all choices visible at once.
Choice	Checkboxes	A list of checkboxes allowing multiple selections, with optional minimum and maximum selection limits.
Choice	Toggle	A single on/off switch returning true or false. Use for yes/no situations where a toggle is clearer than a checkbox.
Choice	Consent	A required checkbox with a customisable consent statement. The form cannot be submitted unless the checkbox is ticked.
Structured and Advanced	Address	A structured address block with separate sub-fields for street, city, state, postcode, and country.
Structured and Advanced	File Upload	Allows the respondent to attach a file. Useful for collecting documents, photos, or supporting evidence.
Structured and Advanced	Rating	A star-rating input. Default is 1-5 stars, with a configurable maximum.
Structured and Advanced	Slider	A range slider with a configurable minimum, maximum, and step value. Good for satisfaction scores or budget ranges.
Structured and Advanced	Signature	An embedded signature pad. The respondent signs with a mouse or finger, and the signature is stored as an image.
Structured and Advanced	Hidden	A field that is never shown to the respondent but is included in the submission data. Use to pass static values into the submission or Salesforce.
Structured and Advanced	Salesforce Related List	A table of related Salesforce records for the respondent to select from. Requires a Salesforce connection.
Layout and Display	Heading	A heading (H2, H3, or H4) inside a section. Use to break a long section into sub-groups.
Layout and Display	Paragraph	A block of static text. Use for instructions, explanations, or context.
Layout and Display	Content Block (Rich Text)	A formatted HTML block supporting bold, italic, lists, links, and more. Use for more complex explanatory content.
Layout and Display	Divider	A horizontal rule. Use to visually separate groups of fields within a section.
Layout and Display	Image	Embeds an image by URL. Use for logos, diagrams, or supporting visuals.

Field Settings

Click any field in the form builder canvas to open its settings in the right-hand panel. Settings are grouped into two tabs.

General Tab

These settings are available on every field type.

Setting	Description
Label	The question or field name shown to the respondent
Placeholder	Light grey hint text inside the input (input fields only)
Help text	A short sentence shown below the field to guide the respondent
Required	If enabled, the form cannot be submitted without a value in this field

Validation Tab

Validation rules depend on the field type. Only applicable rules are shown and these are further described below.

Text and Long Text

Rule	Description
Minimum length	Reject if fewer than N characters
Maximum length	Reject if more than N characters
Custom pattern (regex)	Must match this regular expression
Custom error message	What the respondent sees when validation fails
Disable validation	Turn off all validation for this field

Email

Rule	Description
Minimum length	Minimum character count
Maximum length	Maximum character count
Allowed domains	Only accept addresses from these domains (e.g. maica.com.au, vertic.com.au)
Blocked domains	Reject addresses from these domains
Custom error message	Override the default validation message

Phone

Rule	Description
Custom pattern (regex)	Validate against a phone format (e.g. Australian mobile: ^04\d{8}$)
Custom error message	Message shown on pattern mismatch

Number and Currency

Rule	Description
Minimum value	Reject if less than this number
Maximum value	Reject if greater than this number
Must be whole number	Reject decimals
Maximum decimal places	Allow decimals but no more than N places
Custom error message	Override the default message

Date

Rule	Description
Minimum date	Reject dates before this date. Accepts: today, tomorrow, or a fixed date (YYYY-MM-DD)
Maximum date	Reject dates after this date. Same format as minimum date.
Weekdays only	Reject Saturdays and Sundays
Custom error message	Override the default message

URL

Rule	Description
Must be HTTPS	Reject http:// URLs
Custom error message	Override the default message

Checkboxes and Multi-Select

Rule	Description
Minimum selections	Respondent must choose at least N options
Maximum selections	Respondent may not choose more than N options
Custom error message	Override the default message

Dropdown, Radio, and Checkbox Options

For choice fields, options are entered as a comma-separated or one-per-line list in the Options field.

Layout controls whether options are displayed vertically (stacked) or horizontally (inline). Horizontal layout works best for short option lists.

Logic Tab

See Conditional Logic for full details on showing and hiding fields based on other answers.

Salesforce Tab

See Salesforce Integration for details on mapping fields to Salesforce objects.

Hidden Field Values

For Hidden fields, you set the value that will be submitted:

Value type	Example use
Static text	Pass a form identifier, campaign code, or source label
(future) Form field reference	Combine or pass through another field's value

Hidden fields appear in submissions and can be mapped to Salesforce fields.

Salesforce Related List Settings

For SF Related List fields (requires Salesforce connection):

Setting	Description
Source object	The Salesforce object to query child records from (e.g. Contact)
Display fields	Which fields to show as columns in the selection table
Column labels	Override the column header names
Show column headers	Toggle the header row on/off
Filter (WHERE clause)	SOQL WHERE expression to filter records (e.g. Status__c = 'Active')
Selection mode	Single (radio) or Multiple (checkboxes)
Related object	Junction object to create when a selection is made
Primary field	Lookup field on the junction object pointing to the main record
Selected field	Lookup field on the junction object pointing to the selected record
Linked action ID	Which action step creates the primary record (for chaining)
Additional fields	Extra fields to set on the junction object (static, form field, lookup, date)
Prevent duplicates	Check a field for existing records before creating a new junction

To learn more about the Salesforce Integration in Maica Forms, click here.