Form Elements

Use this page as the element-level reference for process forms. For node compatibility, see Form Building.

Common settings

Most input elements expose the same general settings:

• Label: Display name shown to the person filling out the form. Labels are required and can be up to 64 characters.
• Name: Stable machine name for variables. It is shown in advanced builder mode and can contain letters, numbers, underscores, and dashes.
• Hidden: Keeps the field out of the execution form while preserving its value.
• Read Only: Shows the field but prevents editing. This is not available on Columns, Section Header, or Signature.
• Default: Starting value for the field. Form nodes can use variable-backed defaults for supported text and number fields.
• Hint: Short helper text shown with the field. Hints can be up to 64 characters where supported.
• Required: Prevents the form from completing until the field has a value.
• Width and Width Mobile: Controls how much of the 12-column layout the element uses on desktop and mobile.

Text Input

Text Input collects short text, long text, emails, phone numbers, and URLs.

Use it for names, IDs, comments, short explanations, emails, phone numbers, URLs, and any free-form value that should stay as text.

Options:

• Input Kind: Text, E-Mail, Text Area, Telephone, or URL.
• Autocomplete Enabled: Allows browser autocomplete. When off, the form adds browser and password-manager ignore attributes.
• Minimum Length and Maximum Length: Whole-number limits for text length. Minimum cannot be negative, maximum must be at least 1, and minimum cannot be greater than maximum.
• Pattern (Regex): Validates the completed value with a regular expression. Use this when the final answer must match a precise format.
• Mask Preset: Built-in masks for US phone, US phone plus extension, international phone, US ZIP code, and US ZIP+4. See Input Masking for examples and limitations.
• Custom Mask: Overrides the preset. Supported mask tokens are documented in Input Masking.
• Text Area Rows: Initial height for textarea fields. The maximum is 12 rows.
• Auto Grow: Lets textarea fields expand as the user types.
• Default: Plain defaults, variable defaults, or Liquid template defaults where the node supports variable defaults.

Masking guides the value while the person types. Pattern validation checks the finished value. Use a mask for visible input shape, and use a pattern when the submitted value must pass a strict rule.

Number Input

Number Input collects numeric values that should be stored and compared as numbers.

Use it for amounts, counts, scores, quantities, measurements, and thresholds.

Options:

• Default: Starting numeric value, or a compatible variable default on Form nodes.
• Decimal Places: Controls allowed precision. 0 produces whole numbers.
• Minimum and Maximum: Numeric range validation. Minimum must be less than or equal to maximum.
• Mask: Optional display mask. If left blank and decimal places are configured, Nawfe builds a default numeric mask from the decimal precision. See Input Masking before adding literal prefixes such as currency symbols.

Date / Time

Date / Time collects a date, a time, or a combined date and time.

Use it for due dates, event dates, appointment times, effective dates, expiration dates, and timestamps entered by a user.

Options:

• Mode: Date Only, Time Only, or Date and Time.
• Hint and Required: Standard field guidance and completion controls.
• Past Only and Future Only: Limits date or datetime values to one side of now. These options are mutually exclusive.
• Minimum Date and Maximum Date: Date-only bounds.
• Weekdays Only and Weekends Only: Date-only day-of-week rules.
• Earliest Time and Latest Time: Time-only bounds.
• Minimum Date / Time and Maximum Date / Time: Datetime bounds.
• Minimum Lead Time: Datetime-only lead time such as 90m, 1h, or 2d. Bare numbers are treated as minutes.

Rich Text

Rich Text displays formatted instructions or context inside the form.

Use it for explanatory text, step instructions, policy excerpts, or context that should be visible while someone fills out the form.

Options:

• Content: Rich text content edited in the text editor.
• Variables: On nodes with previous workflow context, content can reference earlier variables.

Rich Text is available in Form nodes and manual start forms. It is not available on Website Form.

Checkbox

Checkbox collects a true or false answer.

Use it for confirmations, acknowledgements, yes/no flags, and simple binary questions.

Options:

• Default: Whether the checkbox starts checked.
• Hidden: Can be used with defaults or logic-controlled values.

Task List

Task List displays a fixed checklist that the form assignee marks complete.

Use it when a form step needs a short checklist inside the same task, such as inspection items, setup steps, or review confirmations.

Options:

• Tasks: Ordered checklist items.
• Task labels: Every task needs a label.
• Required: Requires completion according to the field's validation behavior.

Task List is only available on Form nodes.

Select

Select presents a dropdown list and stores the selected option value and label.

Use it when the user should choose from known options, or when a form field should reference a row from a workspace table.

Options:

• Allow multiple selections: Stores all selected items with labels and values.
• Data source: Manual or Table, where table selection is available.
• Manual items: Options stored directly on the flow config. Manual Select fields support up to 100 options.
• Manual option label, value, and caption: Label is what the user sees, value is what the workflow stores, and caption adds supporting text.
• Source Table: Active workspace table used for table-backed selection.
• Display Fields: Table columns used to render each option.
• Search Fields: Table columns searched when the user types. Search checks these fields with OR logic.
• Caption Fields: Optional table columns shown as secondary text.

Table-backed Select fields load the first 10 rows by default. Table display/search/caption columns are limited to supported displayable table column types.

List row builders do not support table-backed Select fields.

Radio Select

Radio Select presents a short set of visible choices.

Use it when the options are few and the person should see all choices at once, such as yes/no with context, priority, category, or status.

Options:

• Items: Fixed option list edited in the builder.
• Option labels, values, and captions: Captions are optional, but every caption needs a label.
• Option count: Radio groups should contain between 2 and 8 options.
• Hint and Required: Standard field guidance and completion controls.

Use Select instead when the list is long or table-backed.

Team / User Selector

Team / User Selector captures Nawfe users or teams as structured assignee-like values.

Use it when later workflow steps need to assign work, send email, request approval, or route based on a selected person or team.

Options:

• Allow: Choose whether the field accepts users, teams, or both.
• Allow multiple selections: When off, the field accepts exactly one selected user or team.
• Hint and Required: Standard field guidance and completion controls.

Team / User Selector is available in Form nodes and manual start forms. It is not available on Website Form.

File Upload

File Upload collects files during a Form node.

Use it for supporting documents, images, PDFs, exports, evidence files, or attachments that later workflow steps need to inspect or send.

Options:

• Max File Size (MB): Largest allowed file size.
• Max File Count: Maximum number of files the user can upload.

File Upload is only available on Form nodes. Manual start forms and Website Forms do not support uploads.

Signature

Signature captures a regulated electronic signature inside a Form node.

Use it when authorship, review, approval, responsibility, or attestation must be recorded as part of the submitted form record.

Options:

• Require this signature before the step can complete: Makes the signature mandatory.
• Requirement: Full signature or Initials.
• Signature type: Controlled system signature is available. Advanced electronic signature and qualified electronic signature are listed as coming soon and are disabled.
• Signature meaning: Attestation, Authorship, Review, Approval, or Responsibility.
• Signing statement: Text shown to the signer. The statement can be up to 1024 characters.
• Signer input methods: Type, Draw, Upload, or any allowed combination.
• Display size: Small, Medium, or Large.
• Required prior signatures: Other signature fields in the same form that must be completed before this signature can be applied.

Signature is only available on Form nodes.

Section Header

Section Header adds static text to organize a form.

Use it to break a long form into readable groups, name a section, or provide a short visual divider.

Options:

• Label: Header text.
• Text Size: H1, H2, H3, H4, H5, H6, Subtitle 1, Subtitle 2, Body 1, Body 2, Caption, or Overline.
• Hidden: Can hide the header in execution.

Section Header does not collect a value.

Columns

Columns lays out other elements side by side.

Use it to group related fields, create compact row layouts, or keep a form readable without adding more pages.

Options:

• Width and Width Mobile: Overall width of the Columns element.
• Vertical Spacing: Aligns column contents to Start, Center, or End.
• Horizontal Spacing: Start, Center, End, Between, Around, or Evenly.
• Wrap Type: Wrap, Reverse Wrap, or No Wrap.
• Columns: Add, remove, and set widths for individual columns. A Columns element can have up to 12 columns.

Columns can contain other elements allowed by the current form builder. Columns are layout only; they do not collect a value.

List

List collects repeatable rows of structured data.

Use it for line items, inspection rows, repeated observations, people lists, equipment lists, or any repeating set of fields that should stay grouped.

Options:

• Minimum rows: Optional minimum number of rows the user must provide. It must be zero or greater.
• Maximum rows: Maximum number of rows allowed. The default is 50 and the hard limit is 100.
• Table columns: Row fields shown as columns in the list preview/table.
• Edit Row Form: Opens a separate form builder for the fields inside each row.
• Row pages and fields: The row builder can use multiple pages and multiple row fields.

Allowed row elements:

• Text Input
• Number Input
• Date / Time
• Select
• Radio Select
• Checkbox
• Section Header
• Columns

Not allowed in List rows:

• File Upload
• Rich Text
• Task List
• Team / User Selector
• Signature
• Another List

List is available on Form nodes and manual start forms. It is not available on Website Form.