Description
Truelist Email Validator connects your WordPress site to the Truelist email validation API. It checks every email address submitted through your forms before it enters your database — blocking invalid, disposable, and fake addresses at the point of entry.
Why validate emails?
- Reduce bounce rates on your mailing lists
- Keep your CRM and contact database clean
- Stop disposable email signups (Mailinator, Guerrilla Mail, etc.)
- Prevent fake registrations and comment spam
What gets validated
- Invalid emails — addresses that don’t exist or have bad syntax
- Disposable emails — temporary addresses from throwaway services
- Role addresses — generic addresses like info@, admin@, support@
- Failed MX check — domains with no valid mail server
- Non-existent mailboxes — addresses where the mailbox doesn’t exist
- Failed SMTP check — addresses rejected by the mail server
- Bad syntax — addresses that don’t follow email formatting rules
Supported form plugins
- Contact Form 7
- Gravity Forms
- WPForms
- WordPress User Registration
- WordPress Comments
- Universal mode — catches email fields from any other form plugin automatically
Features
- Real-time inline validation as visitors type (optional)
- 24-hour result caching — no redundant API calls
- Fully configurable blocking rules — enable only what you need
- Custom error messages
- API key test button in settings
- Fails open on API errors — your forms never break due to an outage
Requirements
A free or paid Truelist account is required. Sign up at truelist.io to get your API key.
External Services
This plugin connects to the Truelist email validation API to check whether email addresses are deliverable. This service is required for the plugin to function.
What data is sent: The email address submitted through your form is sent to the Truelist API for validation.
When it is sent: An API request is made each time a user submits a form with an email field. Results are cached for 24 hours — repeat submissions with the same address do not trigger a new API call.
Service provider: Truelist (https://truelist.io)
- Terms of Service: https://truelist.io/terms
- Privacy Policy: https://truelist.io/privacy
Installation
- Upload the
truelist-email-validatorfolder to/wp-content/plugins/
— or install directly via Plugins Add New Search for “Truelist” - Activate the plugin via Plugins Installed Plugins
- Go to Settings Truelist
- Paste your API key from truelist.io and click Test API Key
- Enable the blocking rules and form integrations you want
- Click Save Changes
FAQ
-
Do I need a Truelist account?
-
Yes. The plugin uses the Truelist API to validate emails. You can create a free account at truelist.io.
-
Will this break my forms if the Truelist API is down?
-
No. The plugin is designed to fail open — if the API is unreachable or returns an error, the email is allowed through. Your forms will never stop working due to an API outage.
-
Does it slow down my forms?
-
Validation results are cached for 24 hours per email address. After the first check, repeat submissions with the same email skip the API call entirely. The API itself typically responds in under 500ms.
-
Which form plugins are supported?
-
Contact Form 7, Gravity Forms, and WPForms have dedicated integrations. For all other plugins, enable Universal mode in settings — it automatically detects and validates email fields in any form submission.
-
Can I customise the error message?
-
Yes. Go to Settings Truelist and edit the Error message field.
-
Can I block only disposable emails but allow invalid ones through?
-
Yes. Each rule is independently toggleable in the settings page.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Truelist Email Validator” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Truelist Email Validator” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- Support for Contact Form 7, Gravity Forms, WPForms
- Universal mode for all other form plugins
- Real-time on-blur validation
- 24-hour transient caching