# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clearout.io/platform-features/tools/wordpress-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.