Real-time widget

The real-time widget validates an address as the user types it in your signup, checkout, or lead form — catching typos, disposable addresses, and invalid mailboxes before they ever enter your database.

How it works

1. You add a small script to the page with your widget key.
2. The widget watches your email field and verifies on blur/submit.
3. It surfaces feedback (valid, typo suggestion, or block) and can prevent submission of clearly bad addresses.

Keys

The widget uses a publishable widget key (safe for the browser), which is separate from your secret API key. Manage keys in the dashboard. For the programmatic interface, see the Widget API.

What it catches

• Syntax errors and obvious typos (with “did you mean …” suggestions).
• Disposable / throwaway providers.
• Invalid domains / mailboxes via real-time verification.

Adding it to a form

1. In the dashboard, create a widget key and allow-list your domain(s).
2. Add the widget script to your page.
3. Point it at your email input and choose behavior — warn vs block.

<!-- Example shape — confirm the exact snippet in your dashboard. -->
<script src="https://cdn.verifymaill.com/widget.js" defer></script>
<script>
  VerifyMaill.init({
    key: "pk_your_widget_key",
    selector: "#email",
    mode: "block", // or "warn"
  });
</script>

Caution

The snippet above is illustrative. Use the exact script URL and options shown in your dashboard so the version and parameters match your account.

Best practices

• Use warn mode on low-friction forms, block where data quality matters.
• Combine with bulk verification to clean history while the widget protects new sign-ups.