Skip to content

How to Add Google reCAPTCHA in WordPress Form?

Key Takeaways

  • Nexter Blocks Form block adds Google reCAPTCHA to a WordPress form, and the block must be installed and activated.
  • Google reCAPTCHA setup requires a Site Key and Secret Key, which are generated after adding a label, choosing a reCAPTCHA type, entering domain names without http or https, and clicking Submit.
  • Nexter Blocks connects Google reCAPTCHA in Nexter Blocks → Extra Options → Settings, then the Form block uses the Security Code field, Security Options dropdown, and the same reCAPTCHA version used for the keys.
Table of Contents

Google reCAPTCHA stops bots from filling in your forms with spam.

The Form block in Nexter Blocks Pro adds reCAPTCHA through its Security Code field, using keys saved once for your whole site.

For every Form setting in one place, see the Form block guide.

Before You Start

  • Edition: Pro — The Security Code field needs Nexter Blocks Pro.
  • Block to enable: Form, switched on under Nexter > Blocks in your WordPress dashboard.
  • A reCAPTCHA Site Key and Secret Key: register your domain (without http or https) in the Google reCAPTCHA admin console and choose a version. See reCAPTCHA versions.

Add Your Keys

  1. Go to Nexter > Nexter Blocks > Settings.
  1. Turn on Connect Google reCAPTCHA and click its settings icon.
The Connect Google reCAPTCHA card with its switch and settings icon
  1. Paste your keys into Site Key reCAPTCHA v3 and Secret Key reCAPTCHA v3, save the popup, then save the settings page.

Add reCAPTCHA to the Form

  1. In your form, click + and add the Security Code field above the Submit button.
  1. Set Security Options to reCAPTCHA.
  1. Pick the reCAPTCHA Version that matches your keys: v2 (Invisible), v2 or v3. Save.
The Security Code field with Security Options set to reCAPTCHA and the reCAPTCHA Version choices

How It Behaves

  • The reCAPTCHA script loads with the form, using the Site Key from Extra Options.
  • On submit, Google checks the visitor. With v3, submissions with a score below 0.5 are rejected with “reCAPTCHA v3 validation failed or the score is too low.”
  • Only verified submissions run the form actions.

Limitations

  • Pro only.
  • One key pair is saved for the whole site. The fields are labelled v3, but they hold whichever keys you created, so the reCAPTCHA Version in every form must match those keys.
  • Using different reCAPTCHA versions in forms on the same page can cause conflicts.

Troubleshooting

Every submission fails reCAPTCHA

The version in the form does not match the keys, or your domain is missing from the key’s domain list in Google.

The reCAPTCHA badge or box does not appear

Check Connect Google reCAPTCHA is turned on and the Site Key is saved.

Related Docs

Share your Thoughts

Still in Doubt? Let’s Assist You

Have Feedback or Questions?

Join our WordPress Community on Facebook!