Field Types

FastSubmit supports 7 different field types to build any form you need. Each field type has specific validation and formatting.

Unlimited Forms: Create as many forms as you need with any combination of field types. There's no limit on the number of forms or fields per form.

Text

type: "text"

Single-line text input for names, titles, short answers

HTML Input

<input type="text" name="field_id" />

Validation

Any text value

Example Value

John Doe

Email

type: "email"

Email address with built-in format validation

HTML Input

<input type="email" name="field_id" />

Validation

Must be a valid email format (user@domain.com)

Example Value

john@example.com

Textarea

type: "textarea"

Multi-line text input for messages, descriptions, long answers

HTML Input

<textarea name="field_id"></textarea>

Validation

Any text value (supports multiple lines)

Example Value

Hello,\n\nThis is a multi-line message.

Number

type: "number"

Numeric input for quantities, ages, ratings

HTML Input

<input type="number" name="field_id" />

Validation

Must be a valid number

Example Value

42

Date

type: "date"

Date picker for birthdays, appointments, deadlines

HTML Input

<input type="date" name="field_id" />

Validation

Must be a valid date (YYYY-MM-DD format)

Example Value

2024-01-15

Dropdown

type: "select"

Single selection from predefined options

HTML Input

<select name="field_id">\n  <option value="opt1">Option 1</option>\n</select>

Validation

Must match one of the defined options

Example Value

Option 1

Checkbox

type: "checkbox"

Boolean yes/no toggle for agreements, preferences

HTML Input

<input type="checkbox" name="field_id" value="true" />

Validation

true or false

Example Value

true

Field Configuration

Each field in your form can be configured with the following properties:

id(string)Required

Unique identifier used as the field name

label(string)Required

Display label shown to users

type(string)Required

text, email, textarea, number, date, select, checkbox

required(boolean)

Whether the field must be filled

placeholder(string)

Placeholder text shown in empty fields

options(string[])

Array of options for dropdown fields

Property	Type	Required	Description
id	string	Yes	Unique identifier used as the field name in submissions
label	string	Yes	Display label shown to users
type	string	Yes	One of: text, email, textarea, number, date, select, checkbox
required	boolean	No	Whether the field must be filled (default: false)
placeholder	string	No	Placeholder text shown in empty fields
options	string[]	For select	Array of options for dropdown fields

Example Form Configuration

Here's an example of a complete contact form with multiple field types:

{
  "name": "Contact Form",
  "fields": [
    {
      "id": "name",
      "label": "Full Name",
      "type": "text",
      "required": true
    },
    {
      "id": "email",
      "label": "Email Address",
      "type": "email",
      "required": true
    },
    {
      "id": "subject",
      "label": "Subject",
      "type": "select",
      "required": true,
      "options": ["General", "Support", "Sales"]
    },
    {
      "id": "message",
      "label": "Message",
      "type": "textarea",
      "required": true
    }
  ]
}

Common Form Templates

Contact Form

Name, Email, Subject, Message

textemailselecttextarea

Newsletter Signup

Email, Name (optional)

emailtext

Feedback Survey

Rating, Comments, Would Recommend

numbertextareacheckbox

Event Registration

Name, Email, Date, Attendees

textemaildatenumber