Widget for Online Forms

The Email Verification Widget allows you to validate email addresses directly within your website, form, or application in real-time.

Instead of collecting emails first and verifying later, the widget ensures that only valid, usable email addresses are entered into your system at the point of capture.

This helps improve overall data quality, reduce bounce rates, and maintain a strong sender reputation without adding friction to the user experience.

Unlike bulk verification or backend API processing, the widget works as a frontend-triggered, API-backed validation layer, making it ideal for real-time use cases such as:

• Signup forms
• Lead capture forms
• Newsletter subscriptions
• Checkout flows
• Contact forms

How the Widget Works

The widget integrates directly into your frontend and performs verification instantly when a user interacts with your email field.

1. User enters an email address in your form
2. The widget sends the email to Emailable via API
3. Emailable processes the verification in real-time
4. A result is returned instantly
5. Your form logic decides how to handle the result (allow, block, warn, etc.)

The widget returns the same verification statuses used across all Emailable tools:

This entire process typically takes place within milliseconds, ensuring a smooth, uninterrupted user experience.

You can install the Widget on your forms by following our API documentation.

Troubleshooting

Script not installed on the page

First, make sure that the following command works. If it doesn't work, the script isn't loading for a variety of reasons, such as ad-blocking or an incorrect installation.

In a browser console, if you run the following command, you should get the following response:

> window['EmailableObject']
< "emailable"

Email input field does not match the default selector

Next, in a browser console, run the following command to receive a response: the number of inputs that match the query. If 0 is returned, it is likely you are not using an input with the type set to email. If this is the case, you will need to use the inputSelector configuration option that can be found here to target your input using either an HTML Class, ID, or Input Name. You can also set the input to a specific email type. To do this, you will need to have an understanding of basic JavaScript to properly write the selector and basic HTML to understand what the type setting is on an input.

> document.querySelectorAll('input[type=email]').length
< 0

Verifying icon displays, but no result ever shows

In the browser console, go to the Network tab, type verify in the Filter box, and select XHR from the tabs.

Then start typing in the input to be verified. You will likely see a red "Verify" appear in the list. If you click on it and click the Response tab, you should see something like this.

If the response is "Invalid API key," it is usually because you have not properly configured the Trusted Domains for this API Key. If this is the case, please login to your dashboard and find the API Key in the API page. It would have the Security setting set to Public, and when you click Manage, you should see this.

If the Trusted Domains does not include the domain you are trying to install the widget on, that is the problem. All subdomains of a domain listed in the Trusted Domains work.