FF

FIRAFORM

Docs

Comprehensive guides and references for FiraForm.

Field Configuration

Configure field types, validation rules, and data requirements

Fields

The Fields page lets you configure validation rules for each field in your form. Fields are automatically detected when submissions are received, or you can add them manually.

Understanding Field Detection

When someone submits data to your form, Firaform automatically detects new fields and adds them to this page. Each field tracks:

  • Field Name: The parameter name from the form (e.g., email, name, phone)
  • Type: The data type (text, email, number, etc.)
  • Required Status: Whether the field must be filled
  • Validation Rules: Custom rules like min/max length, allowed characters, etc.

Locked vs Unlocked Fields

Fields that have received submissions show a lock icon đź”’ and cannot be deleted. This prevents accidental data loss. You can still edit their validation rules.

New fields without submissions can be freely deleted.

Field Types

Choose the appropriate type for each field:

  • Text - General text input (names, addresses, etc.)
  • Email - Validates email format automatically
  • Number - Numeric values only
  • URL - Website addresses
  • Color - Color picker values
  • Date - Date values
  • Date & Time - Combined date and time
  • Time - Time values only
  • Array - Multiple values (checkboxes, multi-select)
  • File Upload - File attachments
  • Honeypot - Invisible bot protection field

Adding a Field

  1. Click Add Field button
  2. Enter the field name (must match your HTML form’s name attribute)
  3. Select the field type
  4. Check “Required” if the field must be filled
  5. Configure validation rules (see below)
  6. Click Save Rules

Validation Rules by Type

Text Fields

  • Min/Max Length - Character count limits
  • Allowed Characters - Choose which characters are permitted:
    • Alphabets (a-z, A-Z)
    • Numbers (0-9)
    • Dash (-)
    • Underscore (_)
    • Spaces
  • Transform - Automatically convert to lowercase or UPPERCASE

Email Fields

  • Automatic email format validation
  • Optional maximum length

Number Fields

  • Min/Max Value - Numeric range limits

File Upload Fields

Configure allowed file types and sizes. See the Uploads guide for details.

Honeypot Fields (Bot Protection)

A honeypot is an invisible field that catches automated bots:

  1. Add a honeypot field with a normal-sounding name (e.g., website, company)
  2. Copy the HTML code provided in the modal
  3. Paste it into your HTML form
  4. The field must remain hidden with CSS (display:none)

How it works: Real users won’t see or fill the field, but bots often fill every field they find. If the honeypot is filled, the submission is silently rejected.

Tips:

  • Use a believable field name (not “honeypot” or “bot_check”)
  • Keep it hidden with display:none
  • Add tabindex="-1" so keyboard users don’t accidentally tab into it
  • Don’t label it as a honeypot in your code comments

When Validation Fails

If a form submission fails validation (e.g., required field missing, email format invalid, value too long), the behavior depends on your Form Settings:

  • Error Redirect URL set: Visitors are redirected to your custom error page with validation error details passed as JSON in the URL parameter
  • No Error Redirect URL: Firaform displays its own default error page with the validation messages

See the Settings guide for details on configuring error redirects and handling validation error messages.

Editing Field Rules

  1. Click Edit Rules next to any field
  2. Modify the validation rules
  3. Click Save Rules

Changes apply to future submissions. Past submissions are not affected.

Deleting Fields

Click Delete next to an unlocked field (fields without submissions).

Note: You cannot delete fields that have received submissions. This protects your existing data.

Common Use Cases

Email Newsletter Signup

  • email field - Type: Email, Required: Yes

Contact Form

  • name - Type: Text, Required: Yes, Min: 2, Max: 100
  • email - Type: Email, Required: Yes
  • message - Type: Text, Required: Yes, Min: 10
  • website - Type: Honeypot (bot protection)

Registration Form

  • username - Type: Text, Required: Yes, Min: 3, Max: 20
    • Allow: alphabets, numbers, underscore, dash
    • Transform: lowercase
  • age - Type: Number, Min: 18, Max: 120
  • email - Type: Email, Required: Yes

Tips

  • Start simple: Add basic required/optional rules first
  • Test your form: Submit test data to ensure validation works as expected
  • Use honeypots: Add an invisible honeypot field to block spam bots
  • Be specific: Set character restrictions on text fields to improve data quality
  • Transform data: Use lowercase transform for usernames or slugs