Checkbox 7 - On Premise - Setting up reCAPTCHA

Checkbox 7 contains a reCAPTCHA item type to help stop spam and other types of automated abuse from posting to your survey.  

If you do not wish to use this functionality then you do not need to complete this step.

Using this item requires additional setup as captcha keys are specific to your URL/domain. It is a free service from Google and will require you to setup an account with Google.

Follow these steps to configure your reCAPTCHA keys:

Step 1: Go to the Google reCAPTCHA site

Visit and click the "Admin Console" link. You will need to create a new account if you do not have one.

Step 2: Register your site 

To do this, visit the Google reCAPTCHA Admin Console (Step 1) and press the "+" icon to register a new site.

Under reCAPTCHA v2, choose the reCAPTCHA v2 "Invisible reCAPTCHA" option.

Under domains, add the domain for your survey site. If you are using multiple domain, you only need to add those used for taking surveys.

When complete, copy and save the secret and public keys that are provided.

Step 3: Add reCAPTCHA keys to Checkbox

To do this, you'll need access to the server that's hosting your Checkbox 7 installation.

Find the folder used by the Checkbox API site and navigate to the "configs" folder. Open the captcha.config file and enter the public key into the value for invisibleRecaptchaSiteKey and enter the private key into invisibleRecaptchaSecret. Save the file when complete.

Lastly, restart IIS for the change to take effect on your Checkbox installation.


Have more questions? Submit a request


Please sign in to leave a comment.