Summary
The Email field allows you to present a field that captures email data. It is available under the Advanced Fields section within the form editor.
Email field as displayed in the Field Library
Email field as displayed in the Form Editor.
Common Settings
This field uses only common field settings for the Appearance and Advanced settings. For a description of each of the common field settings, refer to this article. Below you will find description of specialty settings that are particular to this field.
General Settings
| Setting | Description |
|---|---|
| Enable Email Confirmation | Prompts the user to confirm the email address. |
Merge Tags
For more information on the use of merge tags, refer to these articles.
Usage
{Field Name:2}
Modifiers
This merge tag has no modifiers.
Validation
The Email field validates that the submitted value is a properly formatted email address. If the value does not match the expected email format, the entry cannot be submitted, and an error message is displayed in the field.
When the Email Confirmation setting is enabled, validation also checks that the value entered in the Confirm Email input matches the value in the Email input. If the two values do not match, the entry cannot be submitted.
Note: rejected addresses trigger a generic invalid email message. Users are not informed of the specific reason for the failure.
Validation can also be customized or overridden using the gform_field_validation filter.
Extending email validation
The following third-party add-ons can be used to enhance email validation beyond the default behavior:
- Email Validator, which verifies that the email address belongs to an active, reachable domain.
- Zero Spam that blocks disposable and spam-associated email addresses.
Disclaimer: Third-party services, plugins, or code snippets that are referenced by our Support documentation or in Support Team communications are provided as suggestions only. We do not evaluate, test or officially support third-party solutions. You are wholly responsible for determining if any suggestion given is sufficient to meet the functional, security, legal, ongoing cost and support needs of your project.
Feedback, feature, and integration requests, and other functionality ideas can be submitted at http://forms.roadmap.gravity.com/.