Configuring AEV validation rules

Last updated on
10 June 2026

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.org matches bar.example.org and foo.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

Page status: No known problems

You can: