Restriction Modes

The plugin runs in one of two modes. The mode is decided by which list you fill in, not by a separate switch: if the allowed-domains list has any entries, the site is in whitelist mode; otherwise it is in blacklist mode.

Blacklist mode (default)

Block specific domains and allow all others.

1. A user registers with user@tempmail.com.
2. The plugin extracts the domain tempmail.com.
3. If the domain is in the banned list, registration is blocked. Otherwise it proceeds.

Best for public sites that need to block disposable or spam email services.

Whitelist mode

Allow only specific domains and block everything else.

1. A user registers with user@example.com.
2. The plugin extracts the domain example.com.
3. If the domain is in the allowed list, registration proceeds. Otherwise it is blocked.

Best for corporate sites, schools, and exclusive communities.

Priority order

When an email is checked, the plugin evaluates rules in this order:

1. Email whitelist - listed addresses are always allowed.
2. Allowed domains - if this list has entries, only these domains pass and the banned list is ignored.
3. Banned domains - if only this list has entries, these domains are blocked and all others pass.
4. No restrictions - if neither list has entries, all registrations are allowed.

Because a non-empty allowed list makes the banned list irrelevant, choose one mode rather than filling both. If you need exceptions inside a mode, use the email whitelist.