# Wordpress Plugin

The Clearout WordPress plugin **integrates with major WordPress form plugins to validate email addresses in real time upon submission.** This helps keep your lists clean, protects sender reputation, and stops bad sign‑ups before they reach your CRM or ESP

**With** **Clearout + WordPress**, you can:

* Allow only valid email addresses during registration, subscription, and lead capture.​
* Block spam traps, disposable and fake email addresses.​
* Enforce business/work email addresses on specific forms (for example, demo or trial requests).​
* Optionally block free email providers (gmail.com, yahoo.com, outlook.com, etc.) when required.​
* Reduce fraudulent and bot sign-ups, improving overall data quality.

{% embed url="<https://www.youtube.com/watch?v=YG5BrBn7FHo>" %}

## Steps to obtain the Clearout Email Validator Plugin <a href="#keyqj" id="keyqj"></a>

{% stepper %}
{% step %}

### Connect account <a href="#epnt6" id="epnt6"></a>

If you are not an existing Clearout user, firstly [create an account](https://app.clearout.io/register). Existing Clearout users can begin from Step 2

If you are new to Clearout, [create an account](https://app.clearout.io/register). Existing Clearout users can sign in and generate an API token from **Developer → API Tokens** to use with the plugin

<div data-with-frame="true"><figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FWR8aHiKX5eEjoa0VIt7z%2Fconnect-account-6-1024x495.png?alt=media&#x26;token=fdb5b670-c355-49ff-964c-363b2471028a" alt="Clearout Register page to create account"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Install and Activate the Plugin <a href="#qip10" id="qip10"></a>

* Log in to your WordPress admin dashboard.
* Go to **Plugins → Add New**.
* In the search bar, type **“Clearout email validator."**
* Locate the [**Clearout Email Validator**](https://wordpress.com/plugins/clearout-email-validator) plugin and click **Install Now**.
* After installation, click **Activate** to start using the plugin

<div data-with-frame="true"><figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FKzNLSLutxeRowa5KtWFi%2Finstall-clearout-ext-1024x284.png?alt=media&#x26;token=2425272e-4a2a-4614-9cf4-9a0556006757" alt="Add Clearout Email Verification Plugin on Wordpress" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Plugin Setup <a href="#h8w70" id="h8w70"></a>

Finally, please configure the plugin to suit your preferences. Once installed and active, follow these steps. In your WordPress account

* Go to Settings → Clearout email validator
* Enter the [API token](https://app.clearout.io/developer/api/list) (Create one if it does not exist)
* Provide the timeout you wish (the time allowed to validate the email ID once it is submitted by the registrant or subscriber).
* Select the types of email addresses you want to be shown as valid.
* Click on Apply

<div data-with-frame="true"><figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FywzCUmpUoGj8oLTosVZf%2Fplugin-setup-org-1024x609.png?alt=media&#x26;token=b9219bed-45c8-4ed2-9556-fc8048809265" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="info" %} <mark style="color:$info;">**Important note**</mark>&#x20;

Complete a test form immediately after setup to ensure the plugin and validation rules work as intended. For plugin setup testing, use the [test email address](https://docs.clearout.io/developers/api/overview#testing).
{% endhint %}