Contact Form 7 v5.1 dropped support for reCaptcha v2 along with the
[recaptcha] tag December 2018. This plugin brings that functionality back from Contact Form 7 5.0.5 and re-adds the
If this plugin is installed before updating Contact Form 7 from v5.0.5 to v5.1.1 then it will carry over your old API keys. At that point you will just need to head to this plugins settings page to tell the website to use reCaptcha v2.
Once installed and configured it should be the same reCaptcha functionality you are used to in previous versions of Contact Form 7.
Contact Form 7 is required to work with this plugin.
- Install this (ReCaptcha v2 for Contact Form 7) plugin
- Update Contact Form 7 to the latest version
- Re-add the reCaptcha version 2 API keys (if no keys are currently set). For more information you may read How to Generate Google reCAPTCHA v2 Keys by IQComputing and Contact Form 7 documentation
- Using the left-hand admin navigation in the Contact Form 7 subpages click ”reCaptcha Version“ (Contact -> reCaptcha Version)
- Once on the ”ReCaptcha v2 for Contact Form 7“ settings page, select from the select list ”reCaptcha Version 2“ and click ”save“
Once the version 2 API keys are set, the version 2 has been selected in the plugin settings, all [recaptcha] tags will be replaced with the expected Google reCaptcha on all forms.
Will this plugin work with Version 3 keys?
No and yes. Google reCaptcha has specific keys for each API. If you are doing an upgrade from a previous version of Contact Form 7 to the current version you will need to re-add the Version 2 API keys using the traditional method. That being said you can set the plugin usage to default and it will use the inherit Contact Form 7 reCaptcha Version 3 API.
Where do I add my Version 2 keys?
Under Contact -> Integration you can see a ”reCAPTCHA“ service box where you may either ”Setup Integration“ following instructions from the Contact Form 7 documentation. If you already have keys set you will need to click the ”Remove Keys“ button and re-add them following the Contact Form 7 documentation.
I’ve added the Version 2 keys but nothing has changed
If you have added the Version 2 keys and you still do not see the reCaptcha show up on your forms please check the following:
- In WordPress admin, under Contact -> reCaptcha Version please ensure that you have ”reCaptcha Version 2“ selected and saved.
- On your contact forms please ensure that you have the [recaptcha] tag somewhere in the form.
Should the above be correct, at this point it’s time to open a support thread for us to look into the issue further.
Contributors & Developers
“ReCaptcha v2 for Contact Form 7” is open source software. The following people have contributed to this plugin.Contributors
“ReCaptcha v2 for Contact Form 7” has been translated into 16 locales. Thank you to the translators for their contributions.
Interested in development?
- Fixed issue with validation error message not appearing on submission.
- Updated supported version for WordPress 6.0
wp_is_block_theme()to conditionally test if Google ReCaptcha script should be enqueued globally or inline.