Setting up reCAPTCHA for your form embeds

reCAPTCHA tests protect your form embeds from fraudulent submissions.

Support avatar
Written by Support
Updated over a week ago

Google’s reCAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) tests protect your form embeds from fraudulent submissions.

Note: there are multiple versions of reCAPTCHA. For the form embed, use reCAPTCHA v2. This method of reCAPTCHA v2 prompts users to check the ‘I am not a robot’ checkbox and can issue an image, audio, or text challenge to finalize its assessment of a submission request if there is suspicion of the user being a robot.

To set it up, someone at your organization will first need to sign up for a reCAPTCHA account with Google. You or they can sign up for a reCAPTCHA account with Google here.

When you're signing up, select reCAPTCHA v2 as the version to use and fill in all of your domain names where you will be hosting your form embeds. In addition to adding your organization's domain(s), add wearehearken.com. This will allow reCAPTCHA to function when you link directly to the form. Accept Google's terms of service and click Register to complete the process.

You will receive two keys from reCAPTCHA and need both of them to integrate it with your EMS. Once you have them, navigate to your EMS Platform settings:

And put your keys in the Google reCAPTCHA v2 section:

Make sure you hit save at the bottom of this page!

Now when you navigate to your form embeds select ‘Enable reCAPTCHA v2’ when you wish to add reCAPTCHA. This is found on the form editor above the Custom Fields section.

Note: After saving your embed please ensure your reCAPTCHA was set up properly by clicking ‘Show embed codes’ at the bottom of the page then ‘Open direct link’ and fill out a test form. If you receive an error message ensure that your site key and secret key match on the Platform Settings page.

Did this answer your question?