Field Types

What This Feature Does

Field types determine what kind of data can be collected in your forms. Assignar Pay provides over 20 field types ranging from simple text inputs to complex table structures and resource lookups. Each field type has specific configuration options and validation rules.

Field Categories Overview

Input Fields

Input

A single-line text field for short text entry.

Configuration Options:

• Label: Field label text
• Placeholder: Hint text when empty
• Required: Make field mandatory
• Default Value: Pre-filled text
• Max Length: Character limit

Best For:

• Names
• Short answers
• Reference numbers
• Addresses (single line)

Example Uses:

• "Site Address"
• "Order Number"
• "Supervisor Name"

Textarea

A multi-line text field for longer content.

Configuration Options:

• Label: Field label text
• Placeholder: Hint text when empty
• Required: Make field mandatory
• Default Value: Pre-filled text
• Rows: Number of visible text rows

Best For:

• Detailed descriptions
• Comments and notes
• Incident narratives
• Instructions

Example Uses:

• "Describe the hazard observed"
• "Additional comments"
• "Work completed today"

Password

A masked input field for sensitive data.

Configuration Options:

• Label: Field label text
• Placeholder: Hint text
• Required: Make field mandatory

Best For:

• Security codes
• PIN numbers
• Sensitive identifiers

Note: Password fields mask the input but data is stored. Use for UI masking, not security-critical applications.

OTP

One-time password/verification code input.

Configuration Options:

• Label: Field label text
• Length: Number of digits/characters
• Required: Make field mandatory

Best For:

• Verification codes
• Authorization numbers
• Multi-digit codes

Selection Fields

Select

A dropdown menu for choosing one option from a list.

Configuration Options:

• Label: Field label text
• Options: List of available choices
• Required: Make field mandatory
• Default Value: Pre-selected option
• Placeholder: Text when nothing selected

Best For:

• Single selection from many options
• Categories and classifications
• Status selections

Example Uses:

• "Project Status" (Active, On Hold, Completed)
• "Weather Conditions" (Clear, Cloudy, Rain, Storm)
• "Priority Level" (Low, Medium, High, Critical)

Adding Options:

1. Select the field
2. Find "Options" in configuration
3. Click "Add Option"
4. Enter the option label and value
5. Repeat for all options
6. Drag to reorder if needed

MultiSelect

Select multiple options from a list.

Configuration Options:

• Label: Field label text
• Options: List of available choices
• Required: Make field mandatory
• Default Value: Pre-selected options

Best For:

• Multiple category selection
• Applicable conditions
• Multi-select checklists

Example Uses:

• "PPE Worn" (Hard Hat, Safety Vest, Gloves, Safety Glasses)
• "Trades on Site" (Electrical, Plumbing, HVAC, Framing)
• "Issues Found" (Safety, Quality, Schedule, Budget)

Combobox

Searchable dropdown with autocomplete.

Configuration Options:

• Label: Field label text
• Options: List of available choices
• Required: Make field mandatory
• Allow Custom: Allow users to enter values not in the list

Best For:

• Large option lists
• Frequently searched selections
• Semi-open selections

Example Uses:

• "Material Type" (with hundreds of materials)
• "Equipment Model" (searchable list)

RadioGroup

Select one option from a visible list of choices.

Configuration Options:

• Label: Field label text
• Options: List of available choices
• Required: Make field mandatory
• Default Value: Pre-selected option
• Layout: Horizontal or vertical

Best For:

• Few options (2-5)
• When all options should be visible
• Quick single selection

Example Uses:

• "Inspection Result" (Pass, Fail, N/A)
• "Risk Level" (Low, Medium, High)
• "Shift Type" (Day, Night, Swing)

ToggleGroup

Group of toggle buttons for single selection.

Configuration Options:

• Label: Field label text
• Options: List of available choices
• Required: Make field mandatory
• Default Value: Pre-selected option

Best For:

• Visual button-style selection
• Quick toggles between states
• Compact option selection

Example Uses:

• "Completion Status" (Not Started, In Progress, Complete)
• "Rating" (Poor, Fair, Good, Excellent)

Boolean Fields

Checkbox

A single checkbox for yes/no selection.

Configuration Options:

• Label: Field label text
• Required: Require checkbox to be checked
• Default Value: Checked or unchecked by default

Best For:

• Agreements and acknowledgments
• Single yes/no questions
• Confirmation items

Example Uses:

• "I confirm this information is accurate"
• "Site secured at end of day"
• "Toolbox talk completed"

Switch

A toggle switch for on/off selection.

Configuration Options:

• Label: Field label text
• Required: Make field mandatory
• Default Value: On or off by default

Best For:

• Feature toggles
• Enable/disable options
• Status indicators

Example Uses:

• "Equipment operational"
• "Area cleared for work"
• "Permits obtained"

Numeric Fields

Slider

A sliding scale for numeric values.

Configuration Options:

• Label: Field label text
• Min Value: Minimum selectable value
• Max Value: Maximum selectable value
• Step: Increment between values
• Default Value: Starting position
• Required: Make field mandatory

Best For:

• Range selections
• Percentage values
• Quantity estimates

Example Uses:

• "Completion Percentage" (0-100)
• "Satisfaction Rating" (1-10)
• "Estimated Hours" (1-40)

Rating

Star-based rating selection.

Configuration Options:

• Label: Field label text
• Max Rating: Number of stars (typically 5)
• Required: Make field mandatory
• Default Value: Pre-selected rating

Best For:

• Quality ratings
• Performance scores
• Satisfaction levels

Example Uses:

• "Work Quality Rating"
• "Site Cleanliness"
• "Safety Compliance Score"

Date/Time Fields

DatePicker

Select dates, times, or date ranges.

Configuration Options:

• Label: Field label text
• Mode: Single date, date range, or multiple dates
• Include Time: Add time selection
• Required: Make field mandatory
• Default Value: Pre-selected date
• Min Date: Earliest selectable date
• Max Date: Latest selectable date

Modes:

• Single: Pick one date
• Range: Pick start and end dates
• Multiple: Pick multiple individual dates

Best For:

• Event dates
• Inspection dates
• Scheduled times
• Project periods

Example Uses:

• "Inspection Date" (Single)
• "Project Duration" (Range)
• "Work Hours" (Single with time)
• "Unavailable Dates" (Multiple)

File Fields

FileUpload

Upload files and images.

Configuration Options:

• Label: Field label text
• Accepted Types: File extensions allowed (e.g., .pdf, .jpg, .png)
• Max File Size: Maximum file size in MB
• Max Files: Maximum number of files
• Required: Make field mandatory

Best For:

• Photo documentation
• Document attachments
• Supporting evidence

Example Uses:

• "Site Photos"
• "Permit Documents"
• "Damage Photos"
• "Delivery Receipts"

Accepted Types Examples:

• Images: .jpg, .jpeg, .png, .gif
• Documents: .pdf, .doc, .docx
• All: Leave empty for any file type

Special Fields

Signature

Capture handwritten signatures.

Configuration Options:

• Label: Field label text
• Required: Make field mandatory

Best For:

• Acknowledgments
• Approvals
• Certifications
• Legal agreements

Example Uses:

• "Supervisor Signature"
• "Client Approval"
• "Safety Acknowledgment"

How It Works:

1. User clicks/taps the signature area
2. Draws signature using mouse/finger/stylus
3. Click "Clear" to start over
4. Click "Done" to save
5. Signature is stored as an image

Table

Capture tabular data with multiple rows.

Configuration Options:

• Label: Field label text
• Columns: Define table columns with types
• Min Rows: Minimum number of rows required
• Max Rows: Maximum rows allowed
• Required: Make field mandatory

Column Types:

• Text: Free text entry
• Number: Numeric values
• Select: Dropdown selection
• Date: Date picker
• Checkbox: Yes/no toggle

Best For:

• Material lists
• Equipment inventories
• Multiple line items
• Repeated data entry

Example Uses:

• "Materials Used" (Material, Quantity, Unit)
• "Equipment Inspected" (Equipment, Status, Notes)
• "Workers on Site" (Name, Trade, Hours)

Configuring Columns:

1. Select the Table field
2. Click "Add Column"
3. Enter column name
4. Select column type
5. Configure column-specific options
6. Repeat for additional columns

Resource Fields

Resource

Select from internal business data like projects, clients, workers, and equipment.

Configuration Options:

• Label: Field label text
• Resource Type: Type of data to select from
• Required: Make field mandatory
• Filters: Optional filters to narrow options
• Cascading Filters: Filters based on other field values

Available Resource Types:

• Projects
• Clients
• Workers
• Equipment
• Cost Codes
• Activities
• Custom resources (configured by admin)

Best For:

• Linking forms to business data
• Consistent data selection
• Cross-referencing records

Example Uses:

• "Select Project" (links submission to project)
• "Assigned Worker" (select from worker list)
• "Client" (select from client list)

Cascading Filters: Resource fields can filter based on other field values:

1. First field: Select "Client"
2. Second field: Select "Project" filtered by selected Client
3. Projects dropdown only shows projects for the selected client

See Conditional Logic for more on cascading behavior.

Static Elements

Text

Display static text, headings, or instructions.

Configuration Options:

• Content: The text to display
• Variant: H1, H2, H3, or Paragraph

Variants:

• H1: Large heading
• H2: Section heading
• H3: Subsection heading
• P: Regular paragraph text

Best For:

• Form instructions
• Section introductions
• Warnings and notices
• Help text

Example Uses:

• "Complete all fields marked with *"
• "Section 2: Safety Observations"
• "Important: Report all incidents within 24 hours"

Separator

A horizontal line to visually separate content.

Configuration Options:

• Style: Line style (solid, dashed, etc.)

Best For:

• Visual breaks between sections
• Grouping related fields
• Improving form readability

Field Validation

All fields support validation options:

Required Validation

• Toggle "Required" to make the field mandatory
• Form cannot be submitted until field is completed
• Required fields show an asterisk (*) next to their label

Type-Specific Validation

• Input: Min/max length, pattern matching
• Numeric: Min/max values
• DatePicker: Min/max dates
• FileUpload: File types, max size, max count

Custom Validation Messages

• Override default error messages
• Provide specific guidance for users

Tips for Choosing Field Types

• Use Select for 5+ options, RadioGroup for fewer
• Use Textarea for descriptions, Input for short answers
• Use Table for repeated data, not multiple similar fields
• Use Resource for business data, not manual entry
• Use DatePicker with appropriate mode for your date needs
• Use Signature for legal acknowledgments
• Use Text elements for instructions throughout the form

What's Next

After understanding field types, you may want to:

• Learn how to create forms in the Form Builder
• Add dynamic behavior with Conditional Logic
• Set up Workflows for form automation
• Configure Permissions for access control