Configuring AEV validation rules
Go to Administration › Configuration › People › Advanced email validation settings (/admin/config/people/advanced-email-validation). You need the Administer advanced email validation permission.
Choose when user accounts are validated
Under Validate user account mail field on, tick either or both:
- Registration: validate when an account is created.
- Email change: validate when an existing account's email is changed.
Leave both unticked to stop validating user accounts entirely (the Webform handler still works).
Choose the rules
Under Ensure user account email domains are, enable any of:
- Valid (uses an MX lookup): the domain must have a mail (MX) record. On by default.
- Not a disposable email provider (e.g.
mailinator.com). - Not a public/free email provider (e.g.
gmail.com). - Not in your custom list of banned email providers.
A basic format check always runs first, regardless of the rules above. In 3.x and later, a stricter RFC 5322 check also always runs. Neither can be switched off, but you can customize the message each one shows (see below).
Per-rule settings
Each rule has its own section:
- Error message: the message shown when that rule fails. The basic format check has its own message too, as does the RFC 5322 check in 3.x and later.
- Additional domains (disposable and free): extra domains to treat as disposable/free, one per line. These are added to the lists the library fetches.
- Use local domain list only (disposable and free): tick this to use only the domains you enter, and skip fetching the library's online lists.
- Banned domains: your own block list, one domain per line. You can use
*as a wildcard, e.g.*.example.orgmatchesbar.example.organdfoo.bar.example.org.
Enter domains only (the part after @), not full email addresses.
Translating error messages
All error messages can be translated with the core Configuration Translation module. Once it's enabled, go to the settings page and use the Translate tab, or find the configuration under Configuration › Regional and language › Configuration translation.
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion