Form Field Types

Overview

When building a form in App Manager, you choose from a specific set of input components known as “Field Types” to capture data.

Field Attributes

Each field can be customized using the attributes below.

NOTE: App Manager only displays the attributes relevant to the specific field type you have selected.

Attribute	Description
Field Code	A unique internal identifier used to process form data. Cannot contain spaces.
Field Type	Determines the kind of data users can input.
Field Label	Provides context to the user. Appears as a header above the input field.
Field Placeholder	Example text or a hint inside the input box. Not sent to the backend on submission.
Visible	Controls whether the field appears to the user in the app.
Editable	Controls whether the user can change the field's value.
Validation	Currently supports the "Required" rule, forcing input before the form can be submitted.

App Manager Field Types

Basic Fields

Barcode: Opens a scanner for standard barcodes and QR codes. This type also allows for manual entry.
Boolean (Yes/No Field): A simple choice between True or False. It shows up as a toggle switch on iOS and a checkbox on Android.
Currency: Formatted for monetary values.
Current Location: Automatically captures GPS coordinates when the form is sent.
TIP: Set the disclaimer metadata option in this field so users know their location is being recorded.
Date: Captures a date (defaults to the current date).
Date & Time: Captures both date and time. Auto-populates when tapped, but remains editable.
NOTE: If marked invisible, it still captures the data quietly.
Form Scan: Opens the camera for in-form document scanning.
NOTE: Form Scan is limited to one per form.
Number: Accepts numeric values.
Option List: A single-select list. The label is visible to the user while the unique value is sent to your backend.
Option List (Multi Choice): A multi-select version of the Option List.
Rating: Lets the user select a 0 to 5-star rating.
Signature: Captures an e-signature via the device's touch screen.
Static Text: Read-only text used for instructions or context.
NOTE: Because STATIC-TEXT accepts no input, it cannot be made required.
Telephone: Formatted specifically for phone numbers.
Text: Captures a short block of text.
Text (Multi Line): Captures a larger block of text.

Document Metadata Fields

These are predefined fields with preset codes that cannot be changed. They serve as metadata for Document Hub routing. Each is limited to one per form.

Bill of Lading Number: Captures a BOL number.
Document Type: A list of document types that allows the user to specify the type of document being scanned. Crucial for distinguishing an enhanced document scan from a standard photo.
IMPORTANT: Requires a Scan Mode field to be present.
Document Type (Multiple Choice): A multi-select version of the Document Type.
Load Number (Free Form Text): Allows for free-form text entry for a load number.
Load Number (Populated List): Presents a pre-filled list of active load numbers for the user to select.
Scan Mode: A specialized field used in conjunction with document scanning to define capture behavior.

NOTE: If a Document Type field is missing from a form, scans default to "enhanced document." We highly recommend including it on all forms used for scanning documents.

Settings Fields

Sound Picker: Selects the mobile app's notification sound. Recommended only for app settings forms.
NOTE: The SOUND-PICKER field type requires developer implementation.