Email field
Use email_input to collect an email address. Add it when your form needs a respondent’s email.
Configuration
These properties are specific to email_input. For shared field properties, see Shared field properties.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
placeholder | string | No | None | Hint text inside the empty input. Supports {{field}} piping. |
defaultValue | string | No | None | Prefills the input. May contain a {{hidden_name}} reference. |
verifyEmail | boolean | No | false | When true, the respondent must prove access to the address before continuing. Available on the Business plan. Requires verificationId. |
verificationId | string | Only when verifyEmail is true | None | Stable id for the verified field, 1–128 characters. Keep it the same if you rename the field. |
blockRiskyEmails | boolean | No | false | Rejects addresses judged risky. |
Validation
A required field with no answer blocks the respondent from continuing. An invalid email address format also blocks the page. When verifyEmail is enabled, the respondent must verify the address before continuing. If blockRiskyEmails is enabled and the address is judged risky, the submission is rejected.
Submission value
The answer is stored as a string containing the email address.
Example
{
"type": "email_input",
"name": "work_email",
"label": "Work email",
"placeholder": "[email protected]",
"required": true,
"verifyEmail": true,
"verificationId": "primary-work-email",
"blockRiskyEmails": true
}