osforms supports 15 field types across input, choice, scale, display, and layout categories.Documentation Index
Fetch the complete documentation index at: https://osforms.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Text Inputs
text
Single-line text input.tel
Phone number input. No format enforcement — accepts any string.url
URL input with format validation.number
Numeric input. Supportsmin / 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.vertical (default), horizontal, grid
checkbox
Multi-select option list. Submitted as an array of selected values.date
Date picker. Value submitted asYYYY-MM-DD.
Scale & Rating
rating
Star (or icon) rating. Defaults to 1–5. Auto-advances in conversational mode.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 inclassic and stepped modes only. No input collected.
Common Field Properties
Every field shares these properties:| Property | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Unique identifier within the form. Used as the key in submissions. |
type | FieldType | Yes | One of the 15 types above. |
label | string | Yes | Question text shown to the user. |
description | string | No | Helper text displayed below the label. |
placeholder | string | No | Input placeholder text. |
required | boolean | No | Default: false. |
options | FieldOption[] | For choice types | Array of { id, label, value }. |
validation | FieldValidation | No | See below. |
conditionalLogic | ConditionalLogic | No | Show/hide rules. See Conditional Logic. |
config | FieldConfig | No | Type-specific config. |
Validation Reference
| Property | Types | Description |
|---|---|---|
minLength | text, textarea | Minimum character count |
maxLength | text, textarea | Maximum character count |
min | number, scale, rating | Minimum numeric value |
max | number, scale, rating | Maximum numeric value |
pattern | text, email, tel | Regex string for format validation |
patternError | text, email, tel | Custom error message on pattern mismatch |
fileTypes | file | Allowed MIME types or extensions |
maxFileSize | file | Max file size in bytes |