Back to Documentation
Field Types

Text & Number Fields

Master text and number input fields for collecting customer information with validation, formatting, and Smart Pricing integration.

6 min read
Updated December 2024
Text & Number Input FieldsEnter your name...TEXT FIELD123NUMBER FIELDuser@example.comEMAIL FIELD+1 (555) 123-4567PHONE FIELD

Text Field

The most versatile field type for collecting single-line text information like names, addresses, and short answers.

Common Use Cases

  • Personal Information: First name, last name, middle initial
  • Contact Details: Company name, job title, department
  • Addresses: Street address, city, postal code
  • Product Customization: Custom text, engraving, personalization

Configuration Options

Placeholder Text

Guide users with example text that disappears when they start typing.

Example: "Enter your full name"

Character Limits

Set minimum and maximum character counts for validation.

Min: 2, Max: 50 characters

Default Values

Pre-fill fields with default text or dynamic values.

Use {user_email} for current user email

Custom Validation

Apply regex patterns for specific formats (ZIP codes, product codes, etc.).

Pattern: ^[A-Z]{2}[0-9]{4}$

Number Field

Specialized for numeric input with built-in validation and Smart Pricing integration for dynamic product pricing.

Smart Pricing Integration

Number fields can automatically calculate prices based on quantity or measurements:

Pricing Modes

1
Fixed Price Per Unit

Set a fixed price that multiplies by the entered quantity.

Example: $5.00 per yard × 10 yards = $50.00
2
Tiered Pricing

Different prices for different quantity ranges.

Example: 1-10: $5.00/unit | 11-50: $4.50/unit | 51+: $4.00/unit
3
Formula-Based

Use custom formulas for complex calculations.

Example: (length × width × $0.50) + $10 setup fee

Number Field Configuration

Value Constraints

  • Min Value: Minimum allowed number
  • Max Value: Maximum allowed number
  • Step: Increment/decrement value
  • Decimals: Allow decimal places

Display Options

  • Prefix: Show text before number ($, #, etc.)
  • Suffix: Show text after number (kg, m², etc.)
  • Spinner: Show +/- increment buttons
  • Formatting: Thousand separators

Email Field

Specialized text field with automatic email format validation and domain verification.

Features

  • Automatic Validation: Ensures proper email format (RFC 5322 compliant)
  • Domain Verification: Optional check for valid email domains
  • Duplicate Detection: Prevent duplicate email submissions
  • Integration: Automatically used for customer notifications

Valid Email Formats

user@example.com
firstname.lastname@company.co.uk
user+tag@example.com
invalid@emailMissing domain extension
@example.comMissing username

Phone Field

International phone number input with format masking and country code support.

Configuration Options

📞 Format Masking

Automatically format phone numbers as users type.

US Format:
(555) 123-4567
International:
+44 20 7123 4567

🌍 Country Code Support

Allow or require country code prefixes.

+1, +44, +61, +81, etc.

URL Field

Website address input with protocol validation and automatic formatting.

Features & Validation

  • Protocol Detection: Automatically adds https:// if missing
  • Format Validation: Ensures valid URL structure
  • Link Verification: Optional check if URL is accessible
  • Display Options: Show as clickable link in admin

URL Format Examples

https://example.com
http://subdomain.example.com/page
example.comAuto-adds https://

Textarea Field

Multi-line text input for longer content like comments, descriptions, and instructions.

Configuration

Rows & Columns

Set initial height and width of the text area.

Auto-Resize

Automatically expand as user types more content.

Character Counter

Show remaining characters available.

Rich Text Editor

Optional WYSIWYG editor for formatted text.

Best Practices

💡 Tips for Better Forms

Use Clear Labels: Tell users exactly what information you need
Good: "First Name" | Bad: "Name 1"
Add Helpful Placeholders: Show format examples
"e.g., 12345 or 12345-6789"
Set Appropriate Limits: Prevent unusually short or long inputs
Name: 2-50 chars | Comments: 10-1000 chars
Use Smart Defaults: Pre-fill when possible
Email: {user_email} | Name: {user_display_name}

Ready for More Advanced Fields?

Explore radio buttons, checkboxes, and choice fields

Learn About Choice Fields →