Skip to main content

Setting up reCAPTCHA for your Shogun forms

Prevent bot submissions and prevent your forms from fraud or abuse.

Updated today

The reCAPTCHA element is perfect for ensuring that your form does not fall victim to bots or misuse.

How to get started reCAPTCHA

To start using reCAPTCHA, you need to sign up for an API key pair for your site. The key pair consists of a site key and secret key. The site key is used to invoke reCAPTCHA service on your site or mobile application. The secret key authorizes communication between your application backend and the reCAPTCHA server to verify the user's response. The secret key needs to be kept safe for security purposes.

Once you have set up your reCAPTCHA, you will be given the site key and secret key to input into Shogun.

Inserting your reCAPTCHA credentials into Shogun

Once you have your reCAPTCHA site key and secret key, you need to add them to Shogun to use the element. Go to the Settings section of your Shogun dashboard, then scroll down to Integrations. Click the Enable button next to Google ReCAPTCHA V2.

Copy and paste your site_key and secret_key from Google into each field, then click Save.

Once your keys have been saved, the ReCAPTCHA element will be available to use in Shogun's Form Box component.

Inserting the reCAPTCHA element onto your page

Now that entering your credentials is easy, you can finally create a form with your element! To get started, simply drag a Form Box onto your page and add the reCAPTCHA element to it.

Please note, reCAPTCHA elements must be placed inside of a Form Box.

Styling the reCAPTCHA element

Changing the appearance of the element

You can change the appearance of your reCAPTCHA element by making it dark or light, depending on the appearance of your website.

Changing the size of the element

You can also choose the size of your element to help keep the styles of the elements consistent with the rest of your page.

Error: Please enable reCAPTCHA V2 integration

If you are seeing this error, this typically means the integration is not set up correctly - please follow the steps above in order to make use of the integration. If this is set up correctly, please ensure that the site_key and secret_key are correct. This error will also be accompanied by a message inside the sidebar:

If this issue persists, please contact our support team, who will be able to look into it for you.

Did this answer your question?