Field Settings

Select a field in the builder to configure it. This is the detailed reference; for help choosing a type, begin with Field Types.

Shared settings

Depending on the type, the Properties panel can show:

Content fields do not show answer-oriented settings. Hidden cannot use display logic. Name and Address manage their own children rather than accepting arbitrary nested fields.

Default values

Choose one source:

• Fixed value — a literal matching the field type.
• Reference — a value selected from the current entry, another form, a Data Table, or another supported source.
• Template — text rendered from fixed content and references.
• Formula — a calculated numeric result.
• Array mapping — for eligible repeatable structures, maps a collection into instances.

Dynamic defaults can react when their dependencies change. FormWork only replaces the current answer while it still matches the previous derived result; once a respondent genuinely overrides it, later source changes preserve their value.

Defaults are evaluated when an entry is created and during relevant answer updates. Validation and display state are recalculated with them.

Browser text-entry options

Text and Email

• Autocomplete: None, Name, Given Name, Family Name, Email, Telephone, Address Line 1, Address Line 2, Postal Code, Country, Organisation.
• Input mode: Default, Text, Numeric, Telephone, Email, URL, Search.
• Auto-capitalise: Default, Off, Sentences, Words, Characters.
• Spellcheck: on/off.
• Minimum / maximum length: optional character counts.

URL

Optional minimum and maximum length.

Textarea

• Rows: 1–20.
• Resize: None, Vertical, Horizontal, Both.
• Optional minimum and maximum length.

Numeric and date options

Number

• Display prefix and suffix.
• Decimal places: optional, 0–10.
• Optional minimum, maximum, and step.
• Thousands separator on/off.
• Input mode: Numeric or Decimal.

Slider

• Minimum, maximum, and step.
• Show current value on/off.
• Display prefix and suffix.
• Slider is always required.

Rating

• Style: Stars, Hearts, Numbers, Emotions.
• Minimum: 0–100; maximum: 1–100.
• Show labels on/off.
• Low and high label text.

Date

Optional minimum and maximum date. There is no disabled-weekday control in the current builder.

Time

• Show seconds on/off.
• Optional minimum and maximum time.
• Step in seconds. When seconds are hidden, use a multiple of 60.

DateTime

Optional minimum and maximum date-time.

Choice options

Manual and dynamic sources

Select, Radio, and Multiple Choice can use:

• Manual options: add, label, reorder, and remove choices. The option’s stable ID is stored.
• Data Source: choose a Data Table and the column used as the visible label. The stable table row ID is stored.

Switching sources changes the available option set. Keep IDs stable after collecting data so historic answers continue to resolve meaningfully.

Select

• Search within options on/off.
• Empty placeholder.
• Allow Other on/off and its label.

Radio

• Empty placeholder.
• Allow Other on/off and its label.

Multiple Choice

• Style: Checkboxes or Pills.
• Layout: Column or Row.
• In Row layout, small-screen and large-screen columns: 1–4.
• Optional minimum and maximum selections.
• Allow Other, with label and input placeholder.

Toggle

• Style: Checkbox, Toggle, Rich Toggle.
• False and true labels for Rich Toggle.
• Require true on/off.

Contact and secure input options

Phone

• Show country-code selector on/off.
• Default country code.

Password

• Minimum length.
• Require confirmation on/off.
• Require uppercase, lowercase, number, and special character independently.

Signature

• Compact: 400 × 120.
• Standard: 500 × 160.
• Large: 600 × 200.

File

• Maximum size per file: 0.1–100 MB; default 10 MB.
• Allowed types as MIME types and/or file extensions.
• Multiple files on/off.
• Minimum and maximum file counts when multiple is enabled; maximum 20.

Structured-field options

Name

• Show Title, Middle Name, and Suffix independently.
• Layout: Row or Column.
• First and last name are the core parts.

Address

• Show Street, Street Line 2, City, State, Postcode, and Country independently.
• Country mode: None, All countries, Specific countries, or Locked country.
• Specific mode: choose allowed countries.
• Locked mode: choose the fixed default country.
• Address lookup on/off.
• Lookup minimum characters: 1–10.
• Optionally restrict lookup suggestions by country.
• Layout: Row or Column.

Address lookup is available when it has been enabled for your FormWork account.

Group

• Layout: Column or Row.
• In Row layout, small-screen and large-screen columns: 1–4.
• Add arbitrary supported child fields.

Content-field options

Heading

• Content mode: Plain or Template.
• Level: h1–h6.

Paragraph

Content mode: Plain or Template.

Button

• Content mode: Plain or Template.
• Type: Button or Link.
• Link URL and open-in-new-tab switch for Link.

HTML

Content mode: Plain or Template, plus HTML content. Unsafe markup is always removed; there is no editor switch to turn this protection off.

Image

URL, alt text, optional width, and alignment: Left, Centre, Right.

Video

URL, autoplay on/off, and controls on/off. YouTube, Vimeo, and direct sources are supported.

Repeatable behaviour

Repeatable is available on eligible, non-system-managed answer fields. The respondent can add, remove, and reorder instances. Show first instance controls the empty state.

Validation rules on a repeated field are evaluated at the appropriate instance path. When a repeatable parent is used in logic, collection-aware operators such as length or empty/not empty are the sensible choices.

Changes and safety

• Settings autosave after a short debounce.
• Field ID and type are immutable after creation.
• Deleting a field removes it from the draft schema; earlier version entries retain historic answers.
• Publish validation checks every setting and prevents an invalid draft from going live.

Next: Conditional Logic, Validation Rules, and Operators Reference.