Field Types Reference

WittyForm provides a wide range of field types organized into four categories. This reference covers every type with its configuration options, validation rules, and recommended use cases.

Basic Input Fields

Short Text

A single-line text input for brief responses.

• Configuration: Label, placeholder, helper text, default value.
• Validation: Required, min/max length, regex pattern.
• Use case: Names, titles, short answers.

Long Text

A multi-line text area for extended responses.

• Configuration: Label, placeholder, helper text, rows (height), default value.
• Validation: Required, min/max length, word count limit.
• Use case: Comments, descriptions, cover letters, feedback.

Number

Accepts numeric input only. Displays increment/decrement controls.

• Configuration: Label, placeholder, default value, step increment, prefix, suffix.
• Validation: Required, min/max value, integer only.
• Use case: Quantity, age, budget, measurements.

Email

A text input with built-in email format validation.

• Configuration: Label, placeholder, helper text.
• Validation: Required, format auto-validated, domain allowlist/blocklist.
• Use case: Contact forms, registration, newsletter signup.

Phone Number

Phone input with country code selector and format validation.

• Configuration: Label, default country, placeholder.
• Validation: Required, format validation per country.
• Use case: Contact information, SMS verification, support forms.

URL

A text input that validates URLs.

• Configuration: Label, placeholder, helper text.
• Validation: Required, valid URL format.
• Use case: Portfolio links, social profiles, website references.

Password

Masked text input for sensitive data.

• Configuration: Label, placeholder, show/hide toggle.
• Validation: Required, min length, complexity rules (uppercase, number, symbol).
• Use case: Account creation, secure forms.

Selection Fields

Multiple Choice

Radio button group where respondents select one option.

• Configuration: Label, options list, "Other" option toggle, option layout (vertical/horizontal), randomize order.
• Validation: Required.
• Use case: Single-answer questions, surveys, preference selection.

Checkbox Group

Multiple selection from a list of options.

• Configuration: Label, options list, "Other" option, "Select All" toggle, layout, randomize.
• Validation: Required, min/max selections.
• Use case: Interests, skills, multi-select surveys.

Dropdown

A select menu that collapses options into a compact dropdown.

• Configuration: Label, options list, placeholder, searchable toggle, default value.
• Validation: Required.
• Use case: Country selection, categories, long lists of options.

Multi-Select Dropdown

A dropdown that allows selecting multiple values with tag-style display.

• Configuration: Label, options list, placeholder, searchable, max selections.
• Validation: Required, min/max selections.
• Use case: Tags, multi-category classification, skills selection.

Yes / No

A simple binary choice presented as two buttons.

• Configuration: Label, custom labels for yes/no.
• Validation: Required.
• Use case: Confirmations, consent, simple decisions.

Picture Choice

Selection via clickable image cards.

• Configuration: Label, images with captions, single/multi select, grid columns. Click the empty tile in the field settings to upload an image from your computer (max 1 MB, JPG/PNG/WebP/GIF) or paste an external URL.
• Validation: Required, min/max selections (multi mode).
• Use case: Product selection, visual surveys, design preference.

Autocomplete

Searchable input with suggestions from a predefined list.

• Configuration: Label, options list, placeholder.
• Validation: Required.
• Use case: City selection, product search, long option lists.

Advanced Fields

Date Picker

Calendar-based date selection.

• Configuration: Label, date format, min/max date, disabled dates, default value.
• Validation: Required, date range.
• Use case: Appointments, deadlines, birthdates, event scheduling.

Time Picker

Time selection with hour/minute controls.

• Configuration: Label, 12h/24h format, minute interval (1, 5, 15, 30), min/max time.
• Validation: Required, time range.
• Use case: Scheduling, availability, event start times.

Date and Time

Combined date and time selection in a single field.

• Configuration: Label, date format, min/max date.
• Validation: Required, date range.
• Use case: Event scheduling, appointment booking, deadline setting.

Rating

Star-based rating input (1-5 or 1-10).

• Configuration: Label, max stars, icon style (stars, hearts, thumbs), half-star toggle.
• Validation: Required, minimum rating.
• Use case: Product reviews, satisfaction surveys, NPS.

Scale / Slider

A slider input along a numeric range.

• Configuration: Label, min/max value, step, start/end labels, default value.
• Validation: Required.
• Use case: Satisfaction scales, confidence levels, budget ranges.

Rating Grid

A table with rows (items) and columns (options) for batch rating or selection.

• Configuration: Row labels, column labels, single/multi select per row.
• Validation: Required (all rows or specific rows).
• Use case: Feature comparison, multi-item feedback, course evaluations.

Ranking

Drag and drop ordering of items by preference.

• Configuration: Label, items list, randomize initial order.
• Validation: Required.
• Use case: Priority ranking, preference ordering, feature voting.

File Upload

Allows respondents to attach one or more files.

• Configuration: Label, accepted file types, max file size, max file count, helper text.
• Validation: Required, file type, file size.
• Use case: Resume submission, photo upload, document collection.

Signature

A drawing pad for capturing digital signatures.

• Configuration: Label, pen color, line width, canvas size.
• Validation: Required.
• Use case: Contracts, consent forms, delivery confirmation.

Color Picker

A visual color selector that returns a hex value.

• Configuration: Label, default color, preset swatches.
• Validation: Required.
• Use case: Brand color selection, design preferences.

Special Fields

Payment

Stripe-powered payment collection integrated directly into the form.

• Configuration: Product name, amount, currency, Stripe account.
• Validation: Payment required before submission.
• Use case: Order forms, event tickets, donations.

Address

A structured set of fields for collecting a full postal address.

• Configuration: Label, fields to include (street, city, state, zip, country), default country, autocomplete toggle.
• Validation: Required (individual sub-fields).
• Use case: Shipping forms, event registration, contact directories.

Heading

A non-input element that displays a section title within the form.

• Configuration: Text, heading level (H1-H4), alignment.
• Use case: Section dividers, instructions, form organization.

Paragraph / Description

A rich text block for adding instructions or context between fields.

• Configuration: Rich text content (bold, italic, links, lists).
• Use case: Instructions, disclaimers, context paragraphs.

Divider

A horizontal rule that visually separates form sections.

• Configuration: Line style (solid, dashed, dotted), color, spacing.
• Use case: Visual separation between form sections.

Image

Display an image within the form (not an input field).

• Configuration: Image URL or upload, alt text, width, alignment.
• Use case: Branding, product images, reference diagrams.

Hidden Field

An invisible field that stores data passed via URL parameters or JavaScript.

• Configuration: Field key, default value, URL parameter mapping.
• Use case: UTM tracking, user ID pass-through, referral source, A/B test variants.

Legal / Consent

A checkbox with a legal statement that must be accepted.

• Configuration: Label (supports rich text and links), checked by default toggle.
• Validation: Must be checked to submit.
• Use case: GDPR consent, terms acceptance, privacy policy agreement.

Net Promoter Score (NPS)

A purpose-built 0-10 scale specifically for NPS surveys with standard question text.

• Configuration: Label override, follow-up question toggle.
• Validation: Required.
• Use case: NPS surveys, customer loyalty measurement.

Common Configuration Options

These settings are available on all (or most) field types:

Tip: You can search for field types in the builder sidebar by typing the name. This is faster than scrolling through the full list when you know exactly what you need.