Introduction

reCAPTCHA is a free service that protects your site from spam and abuse. It uses advanced risk analysis techniques to tell humans and bots apart.

This article is in two halves. 

  • Updates for Existing Forms
  • How to add reCAPTCHA to New Forms

Updates for Existing Forms- Please Read!

We have recently made some updates to the way that reCAPTCHA is rendered within forms.  This is based on feedback from the community that the server side validation of reCAPTCHA was confusing for end users and also harder to account for error messaging.

We are changing the way that the reCAPTCHA tag is entered into layouts. If you are using reCATPCHA with custom layouts then you will need to update them the next time you save your form (you will reminded to do so in the Form Builder UI). The forms will stay backwards compatible until this time, and if you are using default layouts then they will update automatically for you.

Currently your custom layout will have a line that looks like either:
{% spam_protection "recaptcha_v2" %}
or
{% spam_protection "recaptcha_v3", action: "signup" %} 

To update this, simply remove that line and replace it with the following:

{% include 'recaptcha' -%} 

Then save your form within the Admin.

Setting Up reCAPTCHA on New Forms

To enable reCAPTCHA on a form, you must first have setup your Integration keys: Integrations.

You can enable reCAPTCHA from the "reCAPTCHA" tab, while editing an existing form. There are two types of captcha available:

v2

Check the checkbox to enable it and select "reCAPTCHA v2" from the dropdown. Click save when you're done.

Finally, ensure that you include the following line of code in your form layout: 

{% include 'recaptcha' -%}

 

v3

Check the checkbox to enable it and select "reCAPTCHA v3" from the drop down and define your sensitivity score (between 0.0 and 1.0). You can also define an action if you wish. Click save when you're done.

Finally, ensure that you include the following line of code in your form layout: 

{% include 'recaptcha' -%}

Related Articles

Did this answer your question?