Installation

Step 1: Get Your API Key

Create a Public API key from your API Keys page.

Important: Be sure to add your domain to the trusted domains list for your Public API key.

Step 2: Install the Widget

Add this code to your HTML, just before the closing </body> tag:

Latest Version (Recommended)

Automatically gets the latest updates and improvements:

<script src="https://verifyforge.com/widget/verifyforge.min.js"></script>
<script>
  verifyforge('apiKey', 'your_public_api_key');
</script>

Pinned Version

Pin to a specific version to avoid unexpected changes:

<script src="https://verifyforge.com/widget/verifyforge-1.0.0.min.js"></script>
<script>
  verifyforge('apiKey', 'your_public_api_key');
</script>

Step 3: Test the Widget

The widget automatically attaches to all input[type="email"] elements. Try typing an email address in any email input on your page to see the widget in action.

Customization (Optional)

Configure the widget to match your requirements:

<script>
  // Configure which email types to allow
  verifyforge('allow', {
    states: ['deliverable', 'risky'],  // Block 'invalid' and 'unknown'
    free: true,           // Allow free providers (Gmail, Yahoo, etc.)
    role: false,          // Block role accounts (info@, support@, etc.)
    disposable: false     // Block disposable/temporary emails
  });

  // Customize messages
  verifyforge('messages', {
    invalid: 'Please enter a valid email address.',
    disposable: 'Temporary email addresses are not allowed.',
    role: 'Please use your personal email address.'
  });

  // Adjust timing
  verifyforge('verifyAfterDelay', 1000);  // Wait 1 second after typing stops
</script>

See the Configuration page for all available options.

Troubleshooting

Widget Not Working

1. Check API Key - Ensure your API key is valid and active
2. Check Domain - Verify your domain is added to the trusted domains list
3. Check Console - Look for error messages in the browser console
4. Check Input Type - Ensure your inputs have type="email" attribute

Rate Limit Errors

If you're seeing rate limit errors, you may have exceeded the 10 verifications per IP per day limit for Public API keys. Consider upgrading to a Private API key for higher limits.

CORS Errors

Make sure you've added your domain to the trusted domains list for your Public API key. The widget will not work on domains that are not on the list.