Skip to main content
The Form Template is optimized for structured one-time data capture. Unlike trackers or lists, forms focus on collecting complete submissions with validation—perfect for intake forms, surveys, registrations, or any structured data collection.

Perfect For

  • Contact forms
  • Registration submissions
  • Intake questionnaires
  • Survey responses
  • Order requests
  • Feedback collection

Key Features

  • Field validation
  • Required field enforcement
  • Submission confirmation
  • Structured data capture
  • Multiple field types
  • Export-ready entries

​
Quick Start

1

Describe your form

Tell Peanuts what data you’re collecting:
  • “Customer intake form”
  • “Event registration”
  • “Product feedback survey”
2

Configure fields

Peanuts suggests relevant fields. Mark required fields and set validation rules.
3

Start collecting

Share or use the form. Each submission creates a complete entry in your helper.

​
Interface Overview

The primary input interface:
  • Field labels — Clear descriptions
  • Input areas — Appropriate controls per type
  • Required indicators — Asterisks on mandatory fields
  • Validation messages — Inline error feedback
View past submissions:
  • Entry cards — Summary of each submission
  • Timestamps — When submitted
  • Full details — Tap to view complete data
After submission:
  • Success message — Confirmation toast
  • Clear form — Ready for next entry
  • View entry — Option to see submitted data

​
Form vs. Other Templates

Form = One-time submissions, validation focus, structured capture
Tracker = Recurring entries, trends over time, statistics
List = Task management, completion tracking, persistence
FeatureFormTrackerList
Primary purposeData captureData loggingTask management
Entry frequencyOne-timeRecurringAs needed
Validation focus✅ High⚡ Medium⚡ Medium
Statistics❌ Optional✅ Built-in❌ Optional
Completion tracking❌ No❌ No✅ Yes
Best forIntake, surveysDaily logsTo-dos

​
Field Types

Forms support all standard field types:

​
Text Fields

TypeUse Case
TextShort answers, names, titles
TextareaLong responses, comments, descriptions
EmailEmail addresses with format validation
PhonePhone numbers
URLWebsite links

​
Selection Fields

TypeUse Case
SelectSingle choice from options
RadioSingle choice, visible options
CheckboxYes/no, agreements, flags
Multi-selectMultiple choices

​
Data Fields

TypeUse Case
NumberQuantities, ratings, scores
DateDates, birthdays, deadlines
TimeAppointment times
ImagePhoto uploads, attachments

​
Validation Rules

​
Required Fields

Mark fields as required to enforce completion: Name (text, required) ← Must be filled Email (text, required) ← Cannot submit without Comments (textarea) ← Optional
Required fields show an asterisk (*) and trigger validation errors if empty on submission.

​
Field Validation

ValidationApplies ToBehavior
RequiredAll typesCannot be empty
Min/Max lengthText, TextareaCharacter limits
Min/Max valueNumberNumeric bounds
FormatEmail, URLPattern matching

​
Held State

When required fields are missing:
  1. Form submission is blocked
  2. Inline error messages appear below invalid fields
  3. Toast notification explains what’s missing
  4. State shows as ⏸ Held until resolved
The “Held” state is a supportive pause, not an error. It ensures complete, quality data collection.

​
Input Methods

​
Web App

Complete form with all fields displayed. Tab through fields or tap to select.
For longer forms, fields can present one at a time for focused input.
Mobile slide-up form with streamlined field layout.

​
Voice Entry

Voice features require Starter plan or higher and consume credits.
Speak form submissions naturally:
  • “New registration: John Smith, email [email protected]”
  • “Feedback from customer: Great service, rating 5 stars”

​
Telegram

Submit via chat:
  • Send structured data matching your form fields
  • Peanuts parses and creates entries

​
Configuration

​
In Edit Mode

Access via the Edit button to:
SettingOptions
Add fieldsCreate new form fields
Field orderDrag to reorder
RequiredToggle mandatory status
PlaceholdersAdd hint text
DefaultsPre-fill common values
OptionsDefine select choices
ThemeColors and icon

​
Field Properties

Each field supports:
PropertyDescription
LabelDisplay name for the field
RequiredWhether field must be filled
PlaceholderHint text when empty
DefaultPre-filled value
Help textAdditional guidance

​
Submission Flow

​
Standard Flow

1

Fill fields

User completes the form, filling required and optional fields.
2

Submit

User taps Submit/Save button.
3

Validation

System checks all required fields and validation rules.
4

Confirmation

Success toast appears. Form clears for next entry.

​
Validation Failure

If validation fails:
  1. Submission is prevented
  2. Fields with errors highlight in red
  3. Error messages appear below invalid fields
  4. Form scrolls to first error

​
Working with Submissions

​
Viewing Entries

All submissions appear in your helper’s entry list:
  • Chronological order (newest first)
  • Summary preview on cards
  • Tap for full details

​
Editing Entries

Tap any entry to:
  • View complete submission
  • Edit any field
  • Delete the entry

​
Exporting Data

Export submissions for external use:
  • CSV — Spreadsheet-compatible
  • PDF — Formatted report
  • Webhook — Send to external systems

​
Tips & Best Practices

Only ask for what you need. Long forms reduce completion rates. Consider breaking into multiple specialized forms.
Pre-fill common values (today’s date, default country) to speed up entry.
Group related fields together. Flow from simple to complex questions.
Labels should be unambiguous. “Full name” is clearer than “Name.”
Don’t use text fields for dates or numbers. Proper types provide better validation and mobile keyboards.

​
Example: Customer Feedback Form

A product feedback collection form: Setup:
  • Name: “Customer Feedback”
  • Icon: 💬 Message
  • Theme: Friendly green
Fields:
  1. Name (text, required)
  2. Email (text, required, email format)
  3. Product (select: Product A, Product B, Product C)
  4. Rating (number, 1-5, required)
  5. What did you like? (textarea)
  6. What could improve? (textarea)
  7. Would you recommend us? (checkbox)
Validation:
  • Name: Required, max 100 characters
  • Email: Required, valid email format
  • Rating: Required, between 1-5

​
Credit Usage

ActionCredits
Creating form1 credit (AI generation)
Submitting entriesFree
Editing entriesFree
Voice submission10 credits (speech-to-text)
ExportingFree

Tracker Template

For recurring data logging

Fields

Deep dive into field configuration

Webhooks

Send submissions to external systems

Reports

Generate PDF reports from entries