Skip to content
RocketVerifierDOCS

Websites and forms

Verify emails on WordPress forms and WooCommerce

In short

Install the RocketVerifier plugin, paste your API key under Settings, RocketVerifier, and every supported form checks the email as the visitor types and again on the server when the form is submitted. Undeliverable and disposable addresses are rejected, and one cached result covers both checks, so each address uses a single credit.

On this page

The RocketVerifier plugin protects every form on a WordPress site. Each supported form plugin gets a server-side check on submit, so a blocked address never gets through, even with JavaScript turned off.

Requires
WordPress 5.0, PHP 7.4
Cost
1 credit per address
Cache
10 minutes
Outage
Forms keep working

Install the plugin#

  1. Install and activate

    In WordPress admin open Plugins, Add New, search for RocketVerifier, then click Install Now and Activate. To install by hand, upload the rocketverifier folder to /wp-content/plugins/ and activate it on the Plugins screen.

  2. Paste your API key

    Open Settings, RocketVerifier, paste a key from API keys and click Save Settings. The page shows Connected and your credit balance.

  3. Choose what to block

    Pick the validation options and form integrations below. Protection starts with the next submission.

Choose what to block#

SettingDefaultWhat it does
Block invalid emailsOnRejects undeliverable addresses: mailboxes that do not exist, domains that cannot receive mail and broken syntax.
Block disposable emailsOnRejects temporary and throwaway addresses.
Enable real-time validationOnChecks the address as the visitor types and shows the result under the field.
Block submissions when the verification service is unavailableOffRejects submissions when the API cannot be reached, returns an error or your credits run out. Leave it off so forms keep working.

deliverable, risky and unknown addresses are accepted. When the API flags a typo, the message suggests the corrected address, for example "Did you mean name@gmail.com?".

Supported forms#

Each integration turns on when its form plugin is active and has its own switch under Form Integrations.

FormServer-side check
Contact Form 7Required and optional email fields.
Gravity FormsEmail fields.
WPFormsEmail fields.
Ninja FormsEmail fields.
WooCommerce checkoutThe billing email, on the classic and the block checkout.
WooCommerce My Account registrationThe registration email.
Any other HTML formLive check only: add data-rv-email to the input.
HTML
<input type="email" name="email" data-rv-email />

The live check runs on every type="email" input, every input with data-rv-email, and the email fields of Contact Form 7 and Gravity Forms.

Credits and caching#

  • 1 credit per verified address. unknown results are free.
  • Results are cached for 10 minutes per address, so the live check and the submission count once. Failed and unknown results are not cached.
  • The public live-check endpoint allows 10 checks per visitor per 60 seconds, which keeps bots from spending your credits.

Customize with filters#

Developers can tune the plugin with WordPress filters:

FilterDefaultUse it to
rocketverifier_rate_limit10Change live checks per visitor per window. Return 0 to turn the limit off.
rocketverifier_rate_limit_window60Change the window in seconds.
rocketverifier_client_ipREMOTE_ADDRSupply the visitor IP behind a proxy or CDN.
rocketverifier_cache_ttl600Change the cache lifetime in seconds. Return 0 to turn caching off.
rocketverifier_request_timeout30Change the HTTP timeout for API calls in seconds.
rocketverifier_block_reasonReturn '' to allow a result, or a reason code to block it. Receives the API response.
rocketverifier_validation_messageRewrite the message shown to the visitor.
rocketverifier_ninja_forms_is_email_fieldTreat other Ninja Forms field types as email fields.
PHP
// Also block role addresses such as info@ and sales@.
add_filter('rocketverifier_block_reason', function ($reason, $verification) {
    if ($reason === '' && ($verification['account']['role'] ?? '') === 'yes') {
        return 'invalid';
    }
    return $reason;
}, 10, 2);

The API returns flags such as account.role as the strings "yes", "no" or "unknown", so compare them explicitly. See the verification result.

Frequently asked questions

What happens if the API cannot be reached?

Submissions go through without verification, so your forms and checkout keep working during an outage or when credits run out. Turn on Block submissions when the verification service is unavailable to reject them instead.

Does the live check and the submit check cost two credits?

No. Each result is cached for 10 minutes per address, so checking while the visitor types and again on submit uses one credit. Unknown results are free and are never cached.

Is my API key exposed to visitors?

No. The browser talks to your own WordPress site through admin-ajax, and only the server calls the RocketVerifier API with the key.

Can I verify a custom form?

Add data-rv-email to its email input for the live check. Server-side checks run for the supported form plugins and WooCommerce.

Updated 11 November 2026Suggest an edit