All Collections
Element Tutorials
Setting up reCAPTCHA for your Shogun forms
Setting up reCAPTCHA for your Shogun forms

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

Updated over a week ago

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, these need to be added into Shogun in order to use the element. Go to the Settings section of your Shogun dashboard, then scroll down to Integrations. Click the Enable button that appears 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 the hard bit is over regarding entering your credentials you can finally create a form with your element! To get started, simply drag a Form Box onto your page and then add the reCAPTCHA element into the Form Box.

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

Styling the reCAPTCHA element

Changing the appearance of the element

There are two options to change the appearance of your reCAPTCHA element: 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 implies that 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 of the sidebar:

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

Did this answer your question?