Back to Community
Home / Community / Plugin → Ninja forms – the contact form builder that grows with you

Troubleshooting Common Ninja Forms reCAPTCHA Errors: A Complete Guide

18 threads Sep 16, 2025 Plugin → Ninja forms – the contact form builder that grows with you

Content

reCAPTCHA integration is a powerful tool for preventing spam submissions in Ninja Forms, but it can sometimes be a source of frustration when errors appear. Based on common community reports, this guide will walk you through the most frequent reCAPTCHA issues and how to resolve them.

Common reCAPTCHA Errors and Their Meanings

Users often encounter one of several specific error messages. Identifying which one you're seeing is the first step to a solution.

  • "Uncaught Error: Missing required parameters: sitekey"
  • "Uncaught Error: Invalid site key or not loaded in api.js"
  • "ERROR for site owner: Invalid key type"
  • "reCAPTCHA validation failed. Please, try again later"
  • "Uncaught ReferenceError: grecaptcha is not defined"

Why These Errors Happen

These errors typically stem from a few core issues:

  1. Using the wrong version of reCAPTCHA keys for your Ninja Forms setup.
  2. Incorrect configuration of keys within the Ninja Forms settings.
  3. JavaScript conflicts caused by other plugins, themes, or caching systems.

Step-by-Step Troubleshooting Guide

1. Verify Your reCAPTCHA Key Version and Type

This is the most critical step. A very common mistake is using a reCAPTCHA v3 key when the form is configured for v2, or vice-versa.

  • For the reCAPTCHA Field (v2 Checkbox): You must use reCAPTCHA v2 "I'm not a robot" Checkbox keys from Google.
  • For the reCAPTCHA v3 Action/Badge: You must use reCAPTCHA v3 keys from Google.

Double-check the key type you created in your Google reCAPTCHA admin console and ensure it matches how you've added it to your form.

2. Check Your Ninja Forms Settings

Navigate to Ninja Forms > Settings and find the reCAPTCHA section. Carefully re-enter your Site Key and Secret Key, ensuring there are no leading or trailing spaces. Save the settings.

3. Perform a Conflict Test

Many errors, particularly those like "grecaptcha is not defined," are caused by conflicts with other scripts on your site.

  1. Disable Caching: Temporarily disable any caching plugins (e.g., WP Rocket, W3 Total Cache) and server-level caching (like Cloudflare). Clear all caches and test the form.
  2. Disable JavaScript Optimization: If you use a plugin like Autoptimize, temporarily turn off JavaScript optimization. If this fixes the issue, you will need to exclude Ninja Forms' reCAPTCHA scripts from being optimized.
  3. Theme and Plugin Conflict Test: Temporarily switch to a default WordPress theme (like Twenty Twenty-Four) and deactivate all plugins except Ninja Forms. If the reCAPTCHA works, reactivate your plugins and theme one by one to identify the culprit. The Health Check plugin can help you do this safely on a live site.

4. Check for Multiple CAPTCHA Plugins

If you have other form plugins installed (like Contact Form 7) that also use reCAPTCHA, ensure they are not loading conflicting scripts, even if their forms aren't on the same page. Try disabling other CAPTCHA plugins as a test.

5. Review Your Google reCAPTCHA Configuration

Log into your Google reCAPTCHA admin panel. For your site's key, verify that:

  • You are using the correct key type (v2 checkbox vs. v3).
  • Your website's domain (e.g., yourdomain.com and www.yourdomain.com) is correctly listed in the "Domains" section.

When All Else Fails

If you have confirmed your keys are correct and the conflict test did not reveal an issue, the problem may be more complex. The 'Ninja Forms – The Contact Form Builder That Grows With You' team has acknowledged specific bugs in the past, such as an issue with hCaptcha whitelisting (bug report #7192). It can be helpful to search the WordPress.org support forums for your specific error message to see if others have found a workaround or if a fix is planned for an upcoming release.

By methodically working through these steps, you can identify and resolve the most common causes of reCAPTCHA errors in Ninja Forms.

Related Support Threads Support