Skip to main content
osforms supports 15 field types across input, choice, scale, display, and layout categories.

Text Inputs

text

Single-line text input.

email

Single-line input with email format validation.

tel

Phone number input. No format enforcement — accepts any string.

url

URL input with format validation.

number

Numeric input. Supports min / max validation.

textarea

Multi-line text input. Defaults to 4 rows.

Choice

select

Dropdown single-select. Supports optional search.

radio

Single-choice visible option list. Auto-advances in conversational mode.
Layout options: vertical (default), horizontal, grid

checkbox

Multi-select option list. Submitted as an array of selected values.

date

Date picker. Value submitted as YYYY-MM-DD.

Scale & Rating

rating

Star (or icon) rating. Defaults to 1–5. Auto-advances in conversational mode.
Icon options: star (default), heart, thumb

scale

NPS-style numeric scale. Auto-advances in conversational mode.

File Upload

file

File upload input.
maxFileSize is in bytes. Default: 10485760 (10 MB). fileTypes accepts MIME types (image/*, application/pdf) or extensions (.pdf, .jpg).

Display

statement

Display-only text block. No input collected. Use for instructions, section headers, or legal notices.

divider

Visual separator. Supported in classic and stepped modes only. No input collected.

Common Field Properties

Every field shares these properties:

Validation Reference