> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.swellsystem.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Form Field Types

# Form Field Types

Complete reference guide for all available form field types.

## Text Input Fields

### Short Text
Single-line text input for names, titles, etc.

**Options:**
- Placeholder text
- Character limit (min/max)
- Input validation (email, phone, URL patterns)
- Default value

**Example:**
```
Label: "First Name"
Type: Short Text
Required: Yes
Placeholder: "Enter your first name"
```

### Long Text
Multi-line textarea for longer responses.

**Options:**
- Placeholder text
- Character limit (min/max)
- Word count display
- Rich text editor (optional)

**Example:**
```
Label: "Message"
Type: Long Text
Required: Yes
Character Limit: 500
```

### Number
Numeric input with validation.

**Options:**
- Min/max values
- Decimal places
- Step increment
- Currency formatting

**Example:**
```
Label: "Amount"
Type: Number
Min: 0
Max: 10000
Step: 0.01
Format: Currency ($)
```

### Email
Email address input with validation.

**Options:**
- Auto-formatting
- Duplicate detection
- Placeholder

**Example:**
```
Label: "Email Address"
Type: Email
Required: Yes
Validation: Email format
```

### Phone
Phone number input with formatting.

**Options:**
- Country code selection
- Auto-formatting
- Validation by country

**Example:**
```
Label: "Phone Number"
Type: Phone
Required: Yes
Country: United States
Format: (XXX) XXX-XXXX
```

### URL
Website URL input with validation.

**Options:**
- Protocol auto-completion
- URL validation

**Example:**
```
Label: "Website"
Type: URL
Placeholder: "https://example.com"
```

### Password
Secure password input.

**Options:**
- Show/hide toggle
- Strength indicator
- Min/max length

**Example:**
```
Label: "Password"
Type: Password
Min Length: 8
Show Strength: Yes
```

## Choice Fields

### Multiple Choice (Radio)
Single selection from options.

**Options:**
- Multiple choice options
- "Other" option with text input
- Horizontal or vertical layout

**Example:**
```
Label: "How did you hear about us?"
Type: Multiple Choice
Options:
  - Social Media
  - Search Engine
  - Referral
  - Other (with text input)
```

### Checkboxes
Multiple selections allowed.

**Options:**
- Multiple checkbox options
- Select all option
- Min/max selections

**Example:**
```
Label: "Interests"
Type: Checkboxes
Options:
  - Technology
  - Marketing
  - Sales
  - Support
Min Selections: 1
```

### Dropdown
Select menu for options.

**Options:**
- Dropdown options
- Searchable dropdown
- Multi-select option
- Default selection

**Example:**
```
Label: "Country"
Type: Dropdown
Options: [List of countries]
Searchable: Yes
Default: "United States"
```

### Rating
Star or emoji rating system.

**Options:**
- Rating scale (1-5, 1-10)
- Star or emoji display
- NPS (Net Promoter Score) option

**Example:**
```
Label: "Rate your experience"
Type: Rating
Scale: 1-5 Stars
Required: Yes
```

### Yes/No
Boolean toggle or radio buttons.

**Options:**
- Custom labels
- Default value

**Example:**
```
Label: "Are you interested in our newsletter?"
Type: Yes/No
Default: No
```

## Date & Time Fields

### Date
Date picker with restrictions.

**Options:**
- Min/max date
- Date format
- Default date

**Example:**
```
Label: "Birth Date"
Type: Date
Min Date: 1900-01-01
Max Date: Today
Format: MM/DD/YYYY
```

### Time
Time picker.

**Options:**
- 12/24 hour format
- Min/max time

**Example:**
```
Label: "Preferred Contact Time"
Type: Time
Format: 12-hour
Default: 9:00 AM
```

### Date & Time
Combined date and time picker.

**Options:**
- Date and time restrictions
- Timezone selection

## File Upload Fields

### File Upload
Upload single or multiple files.

**Options:**
- Single or multiple files
- File type restrictions
- File size limits
- Allowed extensions

**Example:**
```
Label: "Upload Resume"
Type: File Upload
Max Size: 5MB
Allowed Types: PDF, DOC, DOCX
Multiple Files: No
```

### Image Upload
Upload and optionally crop images.

**Options:**
- Image only
- Crop/resize options
- Aspect ratio requirements
- Max dimensions

**Example:**
```
Label: "Profile Picture"
Type: Image Upload
Max Size: 2MB
Allowed Types: JPG, PNG
Aspect Ratio: 1:1 (Square)
Crop: Yes
```

## Advanced Fields

### Signature
Digital signature pad.

**Options:**
- Touch/mouse support
- Required signature

**Example:**
```
Label: "Signature"
Type: Signature
Required: Yes
```

### Payment
Stripe payment integration.

**Options:**
- Payment amount (fixed or from field)
- Currency selection
- Payment description

**Example:**
```
Label: "Payment"
Type: Payment
Amount: $50.00
Currency: USD
Description: "Event Registration"
```

### Address
Complete address input.

**Options:**
- Street address
- City, State, ZIP
- Country selection
- Google Maps autocomplete

**Example:**
```
Label: "Shipping Address"
Type: Address
Fields:
  - Street Address
  - City
  - State
  - ZIP Code
  - Country
Autocomplete: Yes
```

### Name
First name / Last name fields.

**Options:**
- First name / Last name
- Full name
- Title prefix/suffix

**Example:**
```
Label: "Full Name"
Type: Name
Fields:
  - First Name (required)
  - Last Name (required)
  - Title (optional)
```

### Matrix
Grid of questions (rows × columns).

**Options:**
- Multiple rows
- Multiple columns
- Rating matrix

**Example:**
```
Label: "Rate our services"
Type: Matrix
Rows:
  - Customer Service
  - Product Quality
  - Support
Columns:
  - Poor
  - Fair
  - Good
  - Excellent
```

### Ranking
Drag-and-drop ranking.

**Options:**
- List of items to rank
- Minimum items to rank

**Example:**
```
Label: "Rank your priorities"
Type: Ranking
Items:
  - Price
  - Quality
  - Service
  - Support
Min Items: 2
```

### Calculation
Formula-based calculated field.

**Options:**
- Formula definition
- Sum, average, multiply, etc.
- Display calculated result

**Example:**
```
Label: "Total"
Type: Calculation
Formula: quantity * price
Fields Used:
  - quantity (number field)
  - price (number field)
```

## Layout Fields

### Section Break
Visual separator with title.

**Options:**
- Section title
- Description
- Progress indicator

**Example:**
```
Type: Section Break
Title: "Contact Information"
Description: "Please provide your contact details"
```

### Page Break
Multi-page form separator.

**Options:**
- Progress bar
- Step indicator

### HTML Block
Custom HTML content.

**Options:**
- HTML content
- Embed videos, images
- Custom styling

**Example:**
```
Type: HTML Block
Content: "<h2>Welcome</h2><p>Please fill out this form.</p>"
```

### Image
Display image with optional caption.

**Options:**
- Image URL or upload
- Caption
- Clickable image

### Video
Embed video (YouTube, Vimeo).

**Options:**
- Video URL
- Custom video player
- Autoplay (optional)

## Field Configuration

### Common Options

All fields support:
- **Label**: Field label
- **Description**: Help text
- **Required**: Mark as required
- **Placeholder**: Placeholder text
- **Default Value**: Default field value
- **Validation**: Custom validation rules
- **Conditional Logic**: Show/hide based on other fields

### Validation Rules

- Required
- Email format
- Phone format
- URL format
- Min/max length
- Min/max value
- Pattern matching (regex)
- Custom validation

### Conditional Logic

- Show if another field equals value
- Hide if condition is met
- Enable/disable based on other fields
- Jump to specific question

## Best Practices

1. **Choose Right Type**: Select appropriate field type for data
2. **Clear Labels**: Use descriptive, clear labels
3. **Help Text**: Add descriptions for complex fields
4. **Validation**: Set appropriate validation rules
5. **Required Fields**: Mark truly required fields
6. **Default Values**: Use defaults when helpful
7. **Mobile-Friendly**: Ensure fields work on mobile devices