Field Types Reference

The Form Builder provides a comprehensive set of field types to collect information from applicants and their families. This reference covers every available field type.

Text Input Fields

Single-line Text

• Type: text
• Use case: Short text inputs -- names, addresses, custom fields.
• Properties: Label, placeholder, required, half-width, help text.

Multi-line Text (Textarea)

• Type: textarea
• Use case: Longer responses -- additional information, comments, medical notes.
• Properties: Label, placeholder, required, help text, rows.

Email

• Type: email
• Use case: Email addresses with built-in format validation.
• Properties: Label, placeholder, required, half-width.
• Validation: Automatically validates email format.

Phone

• Type: phone
• Use case: Phone numbers with country code selector.
• Properties: Label, placeholder, required, half-width.
• Features: Includes an international country code dropdown.

Number

• Type: number
• Use case: Numeric inputs -- age, number of siblings, years of experience.
• Properties: Label, placeholder, required, half-width.
• Validation: Only accepts numeric input.

Selection Fields

Dropdown Menu (Select)

• Type: select
• Use case: Choose one option from a dropdown list.
• Properties: Label, options list, placeholder, required, half-width.
• Options: Define options as value/label pairs.

Single Choice (Radio)

• Type: radio
• Use case: Choose exactly one option from a visible list.
• Properties: Label, options list, required, inline display.
• Display: Options can be shown inline (horizontal) or stacked (vertical).

Multiple Choice (Multi-select)

• Type: multi_select
• Use case: Select one or more options from a list.
• Properties: Label, options list, required.

Checkboxes

• Type: checkbox_group
• Use case: Toggle multiple independent options on/off.
• Properties: Label, options list, required.

True or False

• Type: true_false
• Use case: Binary yes/no questions -- consent, agreements, confirmations.
• Properties: Label, required.

Matrix Fields

Matrix (Single Choice)

• Type: matrix_single
• Use case: Rating or evaluation grids where each row allows one selection.
• Properties: Row labels, column labels, required.
• Display: Grid format with radio buttons at each intersection.

Matrix (Multiple Choice)

• Type: matrix_multi
• Use case: Grids where each row allows multiple selections.
• Properties: Row labels, column labels, required.
• Display: Grid format with checkboxes at each intersection.

Date and Time

Date

• Type: date
• Use case: Date selection -- birthdate, preferred start date, event dates.
• Properties: Label, required, half-width.
• Features: Date picker interface.

File and Media

Attachment (File Upload)

• Type: file
• Use case: Document uploads -- ID copies, medical records, transcripts, photos.
• Properties: Label, required, accepted file types.
• Limits: Maximum file size is 10 MB.
• Accepted formats: jpg, jpeg, png, gif, webp, avif, heic, heif, pdf, csv, xlsx, xls, doc, docx.

TIP

Uploaded files are stored securely in S3 and served via pre-signed URLs with 15-minute expiry for applicant documents. This ensures files remain private and accessible only to authorized users.

Special Fields

Rating

• Type: rating
• Use case: Star-based rating input for satisfaction surveys or evaluations.
• Properties: Label, required, max rating value.

Signature

• Type: signature
• Use case: Digital signatures for consent forms, agreements, contracts.
• Properties: Label, required.
• Features: Supports draw, type, or upload methods for providing a signature.
• Storage: Captured signatures are saved as PNG files in the same secure file store used by uploaded documents and appear as clickable links on the submission's Files list -- not as inline base64 blobs in the lead's data. This keeps submission records lean and makes signatures previewable in the same modal as any other applicant file.
• Validation: The server validates the uploaded signature by checking the PNG magic bytes and rejects anything else; the maximum size is 2 MB.

Country

• Type: country
• Use case: Country selection with flag icons.
• Properties: Label, required, half-width.
• Features: Searchable dropdown with country flags.

Page Elements

These elements are for form layout and do not collect data:

Heading

• Use case: Section titles within the form.
• Properties: Text content, heading level.

Description

• Use case: Instructional text, explanations, or context for applicants.
• Properties: Rich text content.

Divider

• Use case: Visual separator between form sections.

System Fields

System fields map directly to applicant record fields and are pre-configured:

Field	Type	Maps To
Campus	campus	School campus selection
Academic Year	academic_year	Enrolment period
Program	program	Year group / program selection
Fee	fee	Payment fee (can be added multiple times)

See the System Fields article for full details on system field blocks.

Field Properties Summary

All fields share these common properties:

Property	Description
Label	The visible label shown to the applicant
Required	Whether the field must be filled before submission
Half Width	Display at 50% width (two fields side by side)
Help Text	Additional instructions shown below the field
Placeholder	Hint text shown inside empty fields

Was this helpful?