Form Fields

WPsigner provides a variety of form fields for capturing signer information. This page covers each field type, its properties, and best practices for placement.

Field Types Overview

Field Type	Purpose	Signer Action
Signature	Legal signature capture	Draw or type
Initials	Abbreviated signature	Draw or type initials
Date	Date entry	Auto-fill or select
Text	Single-line input	Type text
Text Area	Multi-line input	Type paragraph
Checkbox	Boolean selection	Click to toggle
Dropdown	Choice from list	Select option

---

Signature Field

The most important field type - captures the signer’s legal signature.

Signature Options for Signers

When completing a signature field, signers can choose:

Method	Description
Draw	Use mouse, finger, or stylus to draw
Type	Type name, rendered in signature font
Upload	Upload an image of their signature

Signature Properties

Property	Description	Default
Required	Must be completed	Yes
Assigned To	Which signer completes this	First signer
Width	Field width	200px
Height	Field height	60px

Signature Best Practices

• Size appropriately - Minimum 150px wide for readable signatures
• Leave space - Don’t crowd with other elements
• Align with lines - Place on existing signature lines in the document
• One per signer - Usually one signature field per signer

Signature Data Captured

When a signer signs, WPsigner records:

• Signature image (PNG)
• Timestamp (UTC)
• IP address
• User agent (browser/device)
• Drawing velocity (for drawn signatures)

---

Initials Field

A smaller version of the signature field for initializing pages or clauses.

When to Use Initials

• Multi-page documents - Initial each page
• Specific clauses - Acknowledge individual sections
• Amendments - Mark changes as reviewed
• Witness marks - Smaller confirmation signatures

Initials Properties

Property	Description	Default
Required	Must be completed	Yes
Assigned To	Which signer	Current signer
Width	Field width	80px
Height	Field height	40px

Initials vs Signature

Aspect	Signature	Initials
Size	Larger	Smaller
Purpose	Main agreement	Page/section acknowledgment
Typical count	1 per signer	Multiple per signer

---

Date Field

Captures the date when the signer completes the document.

Date Behavior

Option	Description
Auto-fill	Automatically uses signing date (default)
Manual entry	Signer selects the date

Date Format

The date format is configured globally in WPsigner → Settings → General:

Format	Example
MM/DD/YYYY	01/15/2026
DD/MM/YYYY	15/01/2026
YYYY-MM-DD	2026-01-15
Month DD, YYYY	January 15, 2026

Date Properties

Property	Description	Default
Required	Must be completed	Yes
Auto-fill	Use current date automatically	Yes
Format	Date display format	Site default

Date Placement Tips

• Place next to signature fields
• Use for agreement dates, not backdating
• Consider timezone differences for international signers

---

Text Field

Single-line text input for short responses.

Common Uses

• Name - Full legal name
• Title - Job title or position
• Company - Organization name
• Address - Single-line address
• Phone - Contact number
• Email - Email address
• ID Number - License, SSN (partial), passport

Text Field Properties

Property	Description	Default
Required	Must be completed	No
Placeholder	Helper text shown before input	Empty
Default Value	Pre-filled value	Empty
Max Length	Character limit	256
Validation	Input format (email, phone, etc.)	None

Text Validation Options

Validation	Accepts
None	Any text
Email	Valid email format
Phone	Numeric with formatting
Number	Digits only
Letters	Alphabetic only

---

Text Area Field

Multi-line text input for longer responses.

Common Uses

• Comments - Additional notes or observations
• Explanation - Detailed responses
• Address - Full multi-line address
• Special instructions - Custom requirements
• Decline reason - Why signer is declining

Text Area Properties

Property	Description	Default
Required	Must be completed	No
Placeholder	Helper text	Empty
Rows	Visible text lines	3
Max Length	Character limit	1000

Text Area vs Text Field

Text Field	Text Area
Single line	Multiple lines
Short input	Long input
Names, emails	Comments, addresses

---

Checkbox Field

Boolean yes/no selection for options and acknowledgments.

Common Uses

• Terms acceptance - “I agree to the terms and conditions”
• Confirmation - “I confirm this information is accurate”
• Options - “Include extended warranty”
• Acknowledgment - “I have read and understood”
• Consent - “I consent to email communication”

Checkbox Properties

Property	Description	Default
Required	Must be checked	No
Checked by default	Pre-checked state	No
Label	Text next to checkbox	Empty

Checkbox Groups

Create related checkboxes for multiple options:

Example: Service Add-ons

• ☐ Priority support (+$99/year)
• ☐ Extended warranty (+$49/year)
• ☐ Training session (+$199 one-time)

Required Checkboxes

When marked as required:

• Signer must check the box to proceed
• Used for mandatory acknowledgments
• Document cannot be completed without checking

---

Dropdown Field

Selection from a predefined list of options.

Common Uses

• State/Province - Select from list
• Country - Select country
• Department - Choose department
• Plan tier - Select service level
• Relationship - Spouse, child, parent, etc.
• Yes/No - Simple binary choice

Dropdown Properties

Property	Description	Default
Required	Must select an option	No
Options	List of choices	Empty
Default	Pre-selected option	None
Placeholder	Text before selection	”Select…”

Adding Options

1. Click the dropdown field in the editor
2. Open the Properties panel
3. In “Options,” add each choice on a new line:

Option 1
Option 2
Option 3

Dropdown vs Checkbox

Use Dropdown	Use Checkbox
Many options (3+)	Yes/No only
Mutually exclusive	Multiple selections possible
Saves space	Self-explanatory

---

Field Placement

Accessing the Field Editor

1. Navigate to Step 3 (Fields) of the document wizard
2. The toolbar appears on the left
3. Document preview in the center
4. Properties panel on the right (when field selected)

Placing Fields

Click Method

1. Click a field type in the toolbar
2. Click on the document where you want it
3. Field appears at cursor position

Drag Method

1. Click and hold a field type
2. Drag to the document
3. Release to place

Moving Fields

• Click and drag any placed field
• Use arrow keys for precise positioning
• Fields snap to alignment guides

Resizing Fields

• Click a field to select it
• Drag corner handles to resize
• Hold Shift to maintain aspect ratio

Deleting Fields

• Select the field
• Press Delete or Backspace
• Or right-click → Delete

---

Field Assignment

Assigning to Signers

When multiple signers exist:

1. Select a field
2. In Properties, find “Assigned To”
3. Select the signer from the dropdown
4. Field changes to signer’s color

Color Coding

Each signer has a unique color:

Signer	Color	Meaning
Signer 1	Blue	Signer 1’s fields
Signer 2	Green	Signer 2’s fields
Signer 3	Orange	Signer 3’s fields

This helps visualize which signer completes which fields.

Field Visibility

• Each signer only sees their assigned fields as editable
• Other signers’ fields appear as read-only
• Completed fields show the entered values

---

Field Properties Reference

Common Properties (All Fields)

Property	Type	Description
assignedTo	Signer	Which signer completes this
required	Boolean	Must be completed
x	Number	X position (% from left)
y	Number	Y position (% from top)
width	Number	Width (% of page)
height	Number	Height (% of page)
page	Number	Page number (1-indexed)

Field-Specific Properties

Signature/Initials

Property	Type	Description
drawEnabled	Boolean	Allow drawing
typeEnabled	Boolean	Allow typing
uploadEnabled	Boolean	Allow upload

Text/Text Area

Property	Type	Description
placeholder	String	Helper text
defaultValue	String	Pre-filled value
maxLength	Number	Character limit

Checkbox

Property	Type	Description
checked	Boolean	Default state
label	String	Display label

Dropdown

Property	Type	Description
options	Array	List of choices
defaultOption	String	Pre-selected value

---

Best Practices

Field Sizing Guide

Field Type	Recommended Width	Recommended Height
Signature	200-300px	60-80px
Initials	60-100px	40-60px
Date	100-150px	30px
Text	150-300px	30px
Text Area	200-400px	60-120px
Checkbox	20px	20px
Dropdown	150-250px	30px

Mobile Considerations

60%+ of documents are signed on mobile devices:

• Make signature fields larger (minimum 200px wide)
• Space fields apart (avoid overlapping)
• Use clear labels
• Test on phone before sending

Accessibility

• Add placeholder text to explain expected input
• Use clear, descriptive labels
• Don’t rely only on color to convey meaning
• Ensure sufficient field sizes for touch input

---

Next Steps

• Creating Documents - Full wizard guide
• Signer Workflows - Signing order options
• Campaigns - Public signing links