> ## Documentation Index
> Fetch the complete documentation index at: https://filla.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Email field

> Email input with validation, typo detection, and one-time code verification.

## What this does

The email field maps to Airtable's Email field type. Beyond collecting an email address, it has a full validation suite: format checking, domain blocking, typo detection, and OTP verification.

Filla always validates that the value is a properly formatted email address before any other checks run. Invalid formats are rejected on both blur and submission with the message "Please enter a valid email address" — no configuration needed.

## Settings reference

### Basic settings

| Setting              | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| **Placeholder text** | Hint text shown when the field is empty.                          |
| **Default value**    | Email pre-filled when the form loads.                             |
| **Force lowercase**  | Automatically converts the input to lowercase on every keystroke. |

### Domain restrictions

| Setting                           | Description                                                                                                                       |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Block free email providers**    | Reject emails from Gmail, Yahoo, Hotmail, Outlook, and 30+ other free providers. Only allows business or custom domain addresses. |
| **Block disposable emails**       | Reject temporary/throwaway addresses (Mailinator, Guerrilla Mail, etc.).                                                          |
| **Suggest corrections for typos** | Show a suggestion when common domains are misspelled, for example "gmai.com" becomes a suggestion for "gmail.com".                |

### Verification

| Setting                               | Description                                                                                                |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Verify email with a one-time code** | Send a 6-digit code to the respondent's email. They must enter the code before they can submit.            |
| **Code expires after (minutes)**      | How long the OTP code remains valid. Default is 10 minutes. Only visible when OTP verification is enabled. |

### Length validation

| Setting                | Description                                             |
| ---------------------- | ------------------------------------------------------- |
| **Minimum characters** | Minimum character count required.                       |
| **Maximum characters** | Maximum character count allowed.                        |
| **Must be unique**     | Reject email addresses that already exist in the field. |

**Universal settings that also apply:** Label, description, required, read-only, conditional visibility, conditional read-only, custom validation rules.

## How OTP verification works

When **Verify email with a one-time code** is enabled:

1. The respondent enters their email address
2. Filla sends a 6-digit code to that address
3. A code entry input appears on the form
4. The respondent enters the code to verify
5. A checkmark badge confirms verification
6. The respondent can request a new code after a short cooldown

<Warning>
  OTP verification adds friction. Use it on forms where you need to confirm the respondent owns the email address: event registration, account creation, or gated content access.
</Warning>

## When to block free email providers

Use **Block free email providers** on B2B lead forms where you want to ensure respondents use a business email. This setting rejects any address from a list of 30+ common free providers including:

* gmail.com, yahoo.com, hotmail.com, outlook.com
* icloud.com, me.com, mac.com
* And 25+ others

## Common questions

<AccordionGroup>
  <Accordion title="Can I use both disposable email blocking and OTP verification?">
    Yes, and it's a strong combination. Disposable email blocking prevents throwaway addresses; OTP verification confirms the respondent can actually receive mail at the address they provided.
  </Accordion>

  <Accordion title="Does typo detection block submission?">
    No. Typo detection shows a suggestion ("Did you mean gmail.com?") but the respondent can ignore it and submit with their original input.
  </Accordion>

  <Accordion title="What happens if the respondent doesn't receive the OTP?">
    They can click "Resend code" after the cooldown. Check that your inbox provider isn't blocking Filla's sending domain.
  </Accordion>
</AccordionGroup>