Setting up the reCAPTCHA Add-On


The official Gravity Forms reCAPTCHA Add-On brings Google’s reCAPTCHA v3 technology as an addition to your anti-spam toolbox. This article describes how to configure the basic settings for use.


For a full list of all the reCAPTCHA Add-On settings, refer to this guide.

Setup Processes

This guide covers the following setup processes for both v2 and v3 reCAPTCHA types.

  1. Getting your keys (v2 or v3).
  2. Adding your keys (v2 or v3).
  3. Setting a score threshold (v3 only).

Getting Your Keys

Google reCAPTCHA keys need to be registered for each site you wish to use the service on. Follow these steps for both v2 and v3 reCAPTCHA services.

  1. Go to Google reCAPTCHA admin.
  2. If necessary, login with your Google developer account.
  3. Click + to generate a key pair for your site. Make sure to generate the correct type of key, as v2 and v3 keys are not interchangeable.
  4. Make note of the two keys you have generated.

Adding Your Keys

To validate the communication between your site and the Google service, you will need to tell Gravity Forms this unique key pair.

  1. Navigate to Forms → Settings → reCAPTCHA.
  2. Enter the site key and secret key you previously recorded under the v2 or v3 settings section.
  3. For v3 keys, you should immediately see a green check mark for both keys, meaning they have been validated.
  4. For v2 keys, choose the version of reCAPTCHA v2 you wish to use, Checkbox or Invisible. This is a site wide setting, and cannot be varied form to form. Note that Checkbox keys are not valid for use with invisible reCAPTCHA.
  5. For v2 keys, you will need to click the “I am not a robot” reCAPTCHA checkbox in order to validate the keys.

Setting a threshold

This process is applicable only to reCAPTCHA v3.

The threshold determines what Gravity Forms will do with form entries based on the reCAPTCHA v3 score they receive. Entries with a reCAPTCHA score less than or equal to this value will be classified as spam. For more information, refer to this Google article.

By default, the threshold is set to 0.5. If you wish to modify this, follow this procedure:

  1. Navigate to Forms → Settings → reCAPTCHA.
  2. Enter the threshold value you wish. The higher the score (from 0 to 1) returned from Google, the more likely it reflects a good interaction.
  3. This threshold value will affect new entries received from that point on.