{"id":292585,"date":"2026-04-10T14:39:59","date_gmt":"2026-04-10T14:39:59","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/truelist-email-validator\/"},"modified":"2026-04-10T14:40:55","modified_gmt":"2026-04-10T14:40:55","slug":"truelist-email-validator","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/truelist-email-validator\/","author":23469793,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"6.9.4","requires":"5.9","requires_php":"8.0","requires_plugins":null,"header_name":"Truelist Email Validator","header_author":"Truelist","header_description":"Validate email addresses in real-time on WordPress forms using the Truelist API. Blocks invalid, disposable, and role-based emails before they enter your database.","assets_banners_color":"","last_updated":"2026-04-10 14:40:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/truelist.io","rating":0,"author_block_rating":0,"active_installs":0,"downloads":32,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"ayushtruelist","date":"2026-04-10 14:40:55"}},"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Settings page \u2014 API key, blocking rules, and form integrations","2":"Registration form blocked with Truelist error message","3":"Contact form blocked in real-time"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[358,12886,2182,18971,2419],"plugin_category":[],"plugin_contributors":[259911],"plugin_business_model":[],"class_list":["post-292585","plugin","type-plugin","status-publish","hentry","plugin_tags-contact-form","plugin_tags-disposable-email","plugin_tags-email-validation","plugin_tags-email-verification","plugin_tags-spam-protection","plugin_contributors-ayushtruelist","plugin_committers-ayushtruelist"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/truelist-email-validator.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>Truelist Email Validator<\/strong> connects your WordPress site to the <a href=\"https:\/\/truelist.io\">Truelist<\/a> email validation API. It checks every email address submitted through your forms before it enters your database \u2014 blocking invalid, disposable, and fake addresses at the point of entry.<\/p>\n\n<h4>Why validate emails?<\/h4>\n\n<ul>\n<li>Reduce bounce rates on your mailing lists<\/li>\n<li>Keep your CRM and contact database clean<\/li>\n<li>Stop disposable email signups (Mailinator, Guerrilla Mail, etc.)<\/li>\n<li>Prevent fake registrations and comment spam<\/li>\n<\/ul>\n\n<h4>What gets validated<\/h4>\n\n<ul>\n<li><strong>Invalid emails<\/strong> \u2014 addresses that don't exist or have bad syntax<\/li>\n<li><strong>Disposable emails<\/strong> \u2014 temporary addresses from throwaway services<\/li>\n<li><strong>Role addresses<\/strong> \u2014 generic addresses like info@, admin@, support@<\/li>\n<li><strong>Failed MX check<\/strong> \u2014 domains with no valid mail server<\/li>\n<li><strong>Non-existent mailboxes<\/strong> \u2014 addresses where the mailbox doesn't exist<\/li>\n<li><strong>Failed SMTP check<\/strong> \u2014 addresses rejected by the mail server<\/li>\n<li><strong>Bad syntax<\/strong> \u2014 addresses that don't follow email formatting rules<\/li>\n<\/ul>\n\n<h4>Supported form plugins<\/h4>\n\n<ul>\n<li>Contact Form 7<\/li>\n<li>Gravity Forms<\/li>\n<li>WPForms<\/li>\n<li>WordPress User Registration<\/li>\n<li>WordPress Comments<\/li>\n<li><strong>Universal mode<\/strong> \u2014 catches email fields from any other form plugin automatically<\/li>\n<\/ul>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Real-time inline validation as visitors type (optional)<\/li>\n<li>24-hour result caching \u2014 no redundant API calls<\/li>\n<li>Fully configurable blocking rules \u2014 enable only what you need<\/li>\n<li>Custom error messages<\/li>\n<li>API key test button in settings<\/li>\n<li>Fails open on API errors \u2014 your forms never break due to an outage<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<p>A free or paid <a href=\"https:\/\/truelist.io\">Truelist<\/a> account is required. Sign up at truelist.io to get your API key.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>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.<\/p>\n\n<p><strong>What data is sent:<\/strong> The email address submitted through your form is sent to the Truelist API for validation.<\/p>\n\n<p><strong>When it is sent:<\/strong> An API request is made each time a user submits a form with an email field. Results are cached for 24 hours \u2014 repeat submissions with the same address do not trigger a new API call.<\/p>\n\n<p><strong>Service provider:<\/strong> Truelist (https:\/\/truelist.io)<\/p>\n\n<ul>\n<li>Terms of Service: https:\/\/truelist.io\/terms<\/li>\n<li>Privacy Policy: https:\/\/truelist.io\/privacy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>truelist-email-validator<\/code> folder to <code>\/wp-content\/plugins\/<\/code>\n\u2014 or install directly via <strong>Plugins \u2192 Add New \u2192 Search for \"Truelist\"<\/strong><\/li>\n<li>Activate the plugin via <strong>Plugins \u2192 Installed Plugins<\/strong><\/li>\n<li>Go to <strong>Settings \u2192 Truelist<\/strong><\/li>\n<li>Paste your API key from <a href=\"https:\/\/truelist.io\">truelist.io<\/a> and click <strong>Test API Key<\/strong><\/li>\n<li>Enable the blocking rules and form integrations you want<\/li>\n<li>Click <strong>Save Changes<\/strong><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20truelist%20account%3F\"><h3>Do I need a Truelist account?<\/h3><\/dt>\n<dd><p>Yes. The plugin uses the Truelist API to validate emails. You can create a free account at <a href=\"https:\/\/truelist.io\">truelist.io<\/a>.<\/p><\/dd>\n<dt id=\"will%20this%20break%20my%20forms%20if%20the%20truelist%20api%20is%20down%3F\"><h3>Will this break my forms if the Truelist API is down?<\/h3><\/dt>\n<dd><p>No. The plugin is designed to fail open \u2014 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.<\/p><\/dd>\n<dt id=\"does%20it%20slow%20down%20my%20forms%3F\"><h3>Does it slow down my forms?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"which%20form%20plugins%20are%20supported%3F\"><h3>Which form plugins are supported?<\/h3><\/dt>\n<dd><p>Contact Form 7, Gravity Forms, and WPForms have dedicated integrations. For all other plugins, enable <strong>Universal mode<\/strong> in settings \u2014 it automatically detects and validates email fields in any form submission.<\/p><\/dd>\n<dt id=\"can%20i%20customise%20the%20error%20message%3F\"><h3>Can I customise the error message?<\/h3><\/dt>\n<dd><p>Yes. Go to <strong>Settings \u2192 Truelist<\/strong> and edit the <strong>Error message<\/strong> field.<\/p><\/dd>\n<dt id=\"can%20i%20block%20only%20disposable%20emails%20but%20allow%20invalid%20ones%20through%3F\"><h3>Can I block only disposable emails but allow invalid ones through?<\/h3><\/dt>\n<dd><p>Yes. Each rule is independently toggleable in the settings page.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Support for Contact Form 7, Gravity Forms, WPForms<\/li>\n<li>Universal mode for all other form plugins<\/li>\n<li>Real-time on-blur validation<\/li>\n<li>24-hour transient caching<\/li>\n<\/ul>","raw_excerpt":"Validate email addresses in real-time on WordPress forms using the Truelist API. Block invalid, disposable, and role-based emails.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/292585","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=292585"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ayushtruelist"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=292585"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=292585"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=292585"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=292585"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=292585"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=292585"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}