What is Google reCAPTCHA?
Google reCAPTCHA is a program that judges whether a user is a human or a robot. You have probably seen some variation of reCAPTCHA.
CAPTCHAs are used by many websites to prevent abuse from 'bots', or automated programs usually written to generate spam. Bots cannot easily submit forms protected by reCAPTCHA. Formidable Forms offers one-click reCAPTCHA (V2) and invisible reCAPTCHA. When setting up reCAPTCHA for your site's forms, you will choose between these two options.
Set up reCAPTCHA
- Create a free account for Google reCAPTCHA if you have not already done so.
- Register the site where you want to use reCAPTCHA. In the setup, please choose between reCAPTCHA V2 and Invisible reCAPTCHA. You will then receive a Site key and a Secret key for the site.
- Go to your site's Formidable → Global Settings → reCAPTCHA. Insert your Site key and Secret key.
- Set the reCAPTCHA type to either 'Checkbox (V2)' or 'Invisible'. Only one type of reCAPTCHA is allowed per site.
- Set the default language for your reCAPTCHA.
- If you will be using multiple reCAPTCHA fields on one page, you must check the option for 'Allow multiple reCAPTCHAs to be used on a single page.'
- Add the reCAPTCHA field to each form you would like protected.
If this is a multi-paged form, place the reCAPTCHA on the last page.
Field options
A reCAPTCHA field has the following options:
Field-specific options
Color
When you insert a reCAPTCHA field into your form, you have the ability to use either a light theme (default) or a dark theme. You can adjust this in the Field Setting of the reCAPTCHA field.
Please note: This setting does not apply to invisible reCAPTCHA.
Size
When you insert a reCAPTCHA field into your form, you have the ability to make the reCAPTCHA window appear its default size, or a compact size as shown below. This is particularly helpful if your form is in a small space! You can adjust this is the Field Options of your reCAPTCHA field.
Please note: This setting does not apply to invisible reCAPTCHA.
reCAPTCHA V3 support
Please note that Formidable does not yet support reCAPTCHA v3, although this is something we plan to add in the future. V3 works in a similar way to Akismet and comes with some downsides. This means v2 will remain popular for some time yet. Invisible v2 and v3 work quite differently, and we believe v3 may not be suitable for all sites.
With reCAPTCHA v3, all form data is uploaded to Google, along with user behavior data. This has implications for GDPR compliance. Because of this, the v3 script loads on all pages along with the badge that links to the privacy agreement and terms. In general, from the feedback we’ve been reading about v3, it still needs some work to make it more reliable. We will continue to monitor V3 development as we plan the best possible integration with Formidable Forms.
How to disable reCAPTCHA
If your form includes a reCAPTCHA and you would like to turn it off, delete the reCAPTCHA field from the form builder page. Delete the reCAPTCHA field on any form that includes a reCAPTCHA that you would like to disable. You can also visit the Formidable -> Global settings page and remove the reCAPTCHA keys.
Troubleshooting
Invisible reCAPTCHA is not invisible
If you are using Invisible reCAPCHA on your site, and Google flags you as suspicious (most likely from submitting your form multiple times from the same IP address), it may display an image challenge after the submit button is clicked. This is expected behavior for Invisible reCAPTCHA to ensure you are a human, and not a robot.
ReCAPTCHA was not entered correctly
When the form is submitted, you may see the message "The reCAPTCHA was not entered correctly".
- Your site keys may not be correct. First, reenter the reCAPTCHA site keys and make sure there are no tabs or spaces in them.
- If your site uses SSL on some pages but not others, you may be getting a cross-site scripting error blocking the script. Try forcing the form pages to use SSL.
- If you have another plugin loading a reCAPTCHA on the same page, they are likely conflicting. Disable other reCAPTCHA plugins.
Invalid domain for Site Key
If you are using reCAPTCHA on your site and you see the error 'ERROR for site owner: Invalid domain for site key', this means your site key is no longer valid.
Also, your website url must match exactly what is included in the site key settings. Subdomains don't need to be added separately. Changes to the domains list may take up to 30 minutes to take effect.
Please register a new key to resolve this issue. If you cannot resolve your issue, feel free to open a help desk ticket for further assistance.
ReCAPTCHA couldn't find user-provided function
This error may be seen when another WordPress plugin is active that loads the reCaptcha in a different way, and included the script on every page. We've specifically seen this with the 'Pie Register' plugin. Learn how to find a conflict in WordPress to prevent the reCAPTCHA from failing.
Google ReCAPTCHA in localhost
If you are working in a local environment, reCAPTCHA will work. However, it will show the message 'The reCAPTCHA is currently running on localhost'. This is normal behavior and the message will disappear when reCAPTCHA is used on a live site.
Cannot contact reCAPTCHA
When a page with a reCAPTCHA is loaded, you may see the error "Cannot contact reCAPTCHA. Check your connection and try again." One reason we have seen for this error, is the reCAPTCHA key is set to v2 but your forms are using invisible reCAPTCHA. Learn how to switch your keys to Invisible reCAPTCHA.
Checkbox reCAPTCHA is not showing
The reCAPTCHA relies on javascript to appear and validate. If nothing appears, this is a common sign of a javascript error on the page. You may also have another reCAPTCHA plugin installed that isn't playing nicely, like Google Captcha (reCAPTCHA) by BestWebSoft.
reCAPTCHA not working in Chrome
We have seen the reCAPTCHA fail in a certain browser. The cases we have seen ended up not being a browser issue, but related to page caching for logged out users. If the reCAPTCHA is working for you in one browser and not another, start by disabling any caching on your site.
Invalid key type
If you are using reCAPTCHA on your site and you see the ERROR for site owner: Invalid key type message, this means that you are using an incorrect reCaptcha key type. For example, V3 keys are not compatible with V2 reCaptcha, and V2 keys are not compatible with Invisible reCaptcha. Key types are not interchangeable.
Please make sure that your generated key type matches with the reCaptcha type you have configured in your Formidable → Global Settings → reCAPTCHA. If you cannot resolve your issue, feel free to open a help desk ticket for further assistance.
reCAPTCHA badge showing
In order to be compliant with the Google terms, the reCAPTCHA badge should be included on the page. To hide this, you can add the custom CSS below on your Formidable → Styles → Custom CSS page.
.frm_form_field .grecaptcha-badge {
display:none;
}