hCaptcha for WordPress


hCaptcha is a drop-in replacement for reCAPTCHA that puts user privacy first.

Need to keep out bots? hCaptcha protects privacy while offering better protection against spam and abuse. Help build a better web.

How hCaptcha Works

The purpose of a CAPTCHA is to distinguish between people and machines via a challenge-response test, and thus increase the cost of spamming or otherwise abusing websites by keeping out bots.

To use this plugin, just install it and enter your sitekey and secret in the Settings -> hCaptcha menu after signing up on hCaptcha.com.

hCaptcha Free lets websites earn rewards while blocking bots and other forms of abuse when a user needs to prove their humanity.

hCaptcha Pro goes beyond the free hCaptcha service with advanced machine learning to reduce the challenge rate, delivering high security and low friction along with more features like UI customization.

Privacy Notices

hCaptcha is designed to comply with privacy laws in every country, including GDPR, LGPD, CCPA, and more.

With the default configuration, this plugin does not:

  • track users by stealth;
  • write any user personal data to the database;
  • send any data to external servers;
  • use cookies.

Once you activate this plugin, the hCaptcha-answering user’s IP address and browser data may be sent to the hCaptcha service on pages where you have activated hCaptcha protection. However, hCaptcha is designed to minimize data used, process it very close to the user, and rapidly discard it after analysis.

For more details, please see the hCaptcha privacy policy at:

Forms and Plugins Supported

  • Login Form
  • Register Form
  • Lost Password Form
  • Comment Form
  • Post/Page Password Form
  • ACF Extended Form
  • Asgaros Forum New Topic Form
  • Asgaros Forum Reply Form
  • Avada Form
  • bbPress New Topic Form
  • bbPress Reply Form
  • Beaver Builder Contact Form
  • Beaver Builder Login Form
  • BuddyPress Create Group Form
  • Buddypress Registration Form
  • Contact Form 7
  • Divi Contact Form
  • Divi Login Form
  • Download Manager Button
  • Elementor Pro Form
  • Fluent Forms
  • Forminator
  • GiveWP Form
  • Gravity Forms
  • Jetpack Forms
  • Kadence Form
  • Mailchimp for WP Form
  • MemberPress Login Form
  • MemberPress Register Form
  • Ninja Forms
  • Otter Blocks Forms
  • Quform Forms
  • Sendinblue Form
  • Subscriber Form
  • Support Candy New Ticket Form
  • Ultimate Member Login Form
  • Ultimate Member Lost Password Form
  • Ultimate Member Register Form
  • WooCommerce Login Form
  • WooCommerce Registration Form
  • WooCommerce Lost Password Form
  • WooCommerce Checkout Form
  • WooCommerce Order Tracking Form
  • WooCommerce Wishlist
  • WPForms Lite
  • wpDiscuz
  • wpForo New Topic Form
  • wpForo Reply Form

Please note

NOTE: This is a community-developed plugin. Your PRs are welcome.

For feature requests and issue reports, please
open a pull request.

We also suggest emailing the authors of plugins you’d like to support hCaptcha: it will usually take them only an hour or two to add native support. This will simplify your use of hCaptcha, and is the best solution in the long run.

Some plugins listed have been superseded by native support, and are included only for legacy purposes.

You should always use native hCaptcha support if available for your plugin.
Please check with your plugin author if native support is not yet available.

Instructions for popular native integrations are below:


  • Login page with hCaptcha widget
  • Login page with hCaptcha challenge
  • WooCommerce Login/Register page
  • Contact From 7 with hCaptcha
  • General settings page
  • Integrations settings page
  • Activating plugin from the Integration settings page


Sign up at hCaptcha.com to get your sitekey and secret, then:

  1. Install hCaptcha either via the WordPress.org plugin repository (best) or by uploading the files to your server. (Upload instructions)
  2. Activate the hCaptcha plugin on the ‘Plugins’ admin page
  3. Enter your site key and secret on the Settings->hCaptcha->General page
  4. Enable desired Integrations on the Settings->hCaptcha->Integrations page


How do I use the hCaptcha plugin?

The hCaptcha plugin supports WordPress core and many plugins with forms automatically. You should select the supported forms on the hCaptcha Integrations settings page.

For non-standard cases, you can use the [hcaptcha] shortcode provided by the plugin.

For example, we support Contact Forms 7 automatically. However, sometimes a theme can modify the form. In this case, you can manually add the [cf7-hcaptcha] shortcode to the CF7 form.

To make hCaptcha work, the shortcode must be inside the


You don’t support plugin X. How can I get support for it added?

Open a PR on GitHub: or just email the authors of plugin X. Adding hCaptcha support is typically quite a quick task for most plugins.

Does the [hcaptcha] shortcode have arguments?

Full list of arguments:

[hcaptcha action="my_hcap_action" name="my_hcap_name" auto="true|false" size="normal|compact|invisible"]

The shortcode adds not only the hCaptcha div to the form, but also a nonce field. You can set your own nonce action and name. For this, use arguments in the shortcode:

[hcaptcha action="my_hcap_action" name="my_hcap_name"]

and in the verification:

$result = hcaptcha_request_verify( 'my_hcap_action', 'my_hcap_name' );

For the explanation of the auto=”true|false” argument, see the section “How to automatically verify an arbitrary form”. By default, auto=”false”.

The argument size=”normal|compact|invisible” allows to set the size of hCaptcha widget. size=”normal” by default.

How to add hCaptcha to an arbitrary form

First, add the hCaptcha snippet to the form.

If you create the form as an HTML block in the post content, just insert the shortcode [hcaptcha] inside it. It may look like this:

<form method="post">
    <input type="text" name="test_input">
    <input type="submit" value="Send">

If you create the form programmatically, insert the following statement inside it:

<form method="post">
    <input type="text" name="test_input">
    <input type="submit" value="Send">
    <?php echo do_shortcode( '[hcaptcha]' ); ?>

Secondly, verify the result of hCaptcha challenge.

$result = hcaptcha_verify_post();

if ( null !== $result ) {
    echo esc_html( $result );
    // Block processing of the form.

How to automatically verify an arbitrary form

Arbitrary user forms can be verified easily. Just add auto="true" or auto="1" to the shortcode:

[hcaptcha auto="true"]

and insert this shortcode into your form.

Auto-verification works with forms sent by POST on frontend only. Also, it works only with forms in the post content, but we have plans to extend the functionality.

How to block hCaptcha on specific page?

hCaptcha starts early, so you cannot use standard WP functions to determine the page. For instance, to block it on my-account page, add this code to your theme’s functions.php file:

* Filter hCaptcha activation flag.
* @param bool $activate Activate flag.
* @return bool
function my_hcap_activate( $activate ) {
  $url = isset( $_SERVER['REQUEST_URI'] ) ?

  if ( '/my-account/' === $url ) {
    return false;

  return $activate;

add_filter( 'hcap_activate', 'my_hcap_activate' );

Skipping hCaptcha verification on a specific form

The plugin has a filter to skip adding and verifying hCaptcha on a specific form. The filter receives three parameters: current protection status (‘true’ by default), source and form_id.

The source is the plugin’s slug (like ‘directory/main-plugin-file.php’), the theme name (like ‘Avada’) or the WordPress core (like ‘WordPress’).

The form_id is the form_id for plugins like Gravity Forms or WPForms, the post id for comments or a general name of the form when the form does not have an id (like WordPress core login form).

For forms provided by WordPress Core, the filter receives the source as ‘WordPress’ and form_id as post_id for comment form, ‘login’, ‘lost_password’, ‘password_protected’, and ‘register’.

Below is an example of how to skip the hCaptcha widget on a Gravity Form with id = 1.

 * Filters the protection status of a form.
 * @param string     $value   The protection status of a form.
 * @param string[]   $source  Plugin(s) serving the form.
 * @param int|string $form_id Form id.
 * @return bool
function hcap_protect_form_filter( $value, $source, $form_id ) {
    if ( ! in_array( 'gravityforms/gravityforms.php', $source, true ) ) {
        // The form is not sourced by Gravity Forms plugin.
        return $value;

    if ( 1 !== (int) $form_id ) {
        // The form has id !== 1.
        return $value;

    // Turn off protection for Gravity form with id = 1.
    return false;

add_filter( 'hcap_protect_form', 'hcap_protect_form_filter', 10, 3 );

How to show hCaptcha widget instantly?

The plugin loads the hCaptcha script with a delay until user interaction: mouseenter, click, scroll or touch. This significantly improves Google Pagespeed Insights score.

To load the hCaptcha widget instantly, you can use the following filter:

* Filters delay time for hCaptcha API script.
* Any negative value will prevent API script from loading at all,
* until user interaction: mouseenter, click, scroll or touch.
* This significantly improves Google Pagespeed Insights score.
* @param int $delay Number of milliseconds to delay hCaptcha API script.
*                   Any negative value means delay until user interaction.
function my_hcap_delay_api( $delay ) {
  return 0;

add_filter( 'hcap_delay_api', 'my_hcap_delay_api' );

How to set hCaptcha language programmatically?

hCaptcha defaults to using the user’s language as reported by the browser. However, on multilingual sites you can override this to set the hCaptcha language to match the current page language. For this, you can use the following filter:

* Filters hCaptcha language.
* @param string $language Language.
function my_hcap_language( $language ) {
  // Detect page language and return it.
  $page_language = 'some lang'; // Detection depends on the multilingual plugin used.

  return $page_language;

add_filter( 'hcap_language', 'my_hcap_language' );

How to whitelist certain IPs

You can use the following filter:

 * Filter user IP to check if it is whitelisted.
 * For whitelisted IPs, hCaptcha will not be shown.
 * @param bool   $whitelisted Whether IP is whitelisted.
 * @param string $ip          IP.
 * @return bool
function my_hcap_whitelist_ip( $whitelisted, $ip ) {

  // Whitelist local IPs.
  if ( false === $ip ) {
    return true;

  // Whitelist some other IPs.
  if ( '' === $ip ) {
    return true;

  return $whitelisted;

add_filter( 'hcap_whitelist_ip', 'my_hcap_whitelist_ip', 10, 2 );

Why isn’t my WPForms Lite installation working?

Please make sure you have removed the reCAPTCHA keys under WPForms > Settings > reCAPTCHA to avoid a conflict.

Where can I get more information about hCaptcha?

Please see our website.


April 22, 2023 2 replies
I'm using a Wordpress Woocommerce Shop and Mollie Payments with Germanized and Astra Theme. I had hCaptcha installed for the checkout of my shop. The last two moths I wondered why nobody ordered anything in my tiny shop (but I was busy with other things and had other stress). Turned out, that the hCaptcha plugin causes a glitch/bug at the payment selection of Mollie Payments. Thanks a lot to the devs of this plugin, I'm so happy. Not. Now I know, why I don't have any sales. I disabled hCaptcha for WooCommerce now. Oh boy...
April 4, 2023 1 reply
I don't know why but every time there's an update, none of my forms work anymore. I don't know why, I don't know how, I'm not a developer. But over eight websites, that's my experience.
April 4, 2023 1 reply
Myself, among others (including Cloudflare back in 2020; they have a blog post about it), moved from reCAPTCHA to hCaptcha with it generally being a nicer experience as a developer, manager, and end-user. This plugin is then instrumental in facilitating hCaptcha on sites. It's then great that there's an official plugin (unlike needing to choose from a handful of 3rd party options where each has their own trade-offs and has a more uncertain support & ongoing development compared to being able to use an official offering. It's also great to see this plugin is active on GitHub (with the plugin's FAQ section in the plugin details pointing people to this) so we can get the combined efforts that might've otherwise been someone creating their own separate plugin (instead, they can add/update what they need in the official plugin for a better overall result.) Finally, their plugin integration/support with anything/everything that might want/need a CAPTCHA is one of the best I've seen in a CAPTCHA plugin (even outside of plugins that are just for hCaptcha.) They're still actively adding more support as of the release made just today (also adding hooks/filters for developers, making sure modern PHP is being accounted for properly, etc.) It definitely makes one think this is the best way to go for any type of CAPTCHA (then the hCaptcha service being one of the best options out there.)
April 2, 2023 1 reply
Plugin is great. Some spam gets through but what are you gonna do. I always use "Easy" difficulty too though, don't want to bug humans too much. If you have your WP login credentials saved in the browser at /wp-admin they are autofilled in hCaptcha settings: Yikes, can't add images - Error: Please do not add links to your review, keep the review about your experience in text only. Here's a link anyway: i . imgur . com / HhPE3gK.png That could be disabled with autocomplete="off" or something, would be nice. Honestly, Secret Key shouldn't be obfuscated anyway, who's watching over my shoulder and memorizing that, I just want to see it to be sure I pasted the right thing. Also setting it up for loads of sites gets a bit tedious, wish there was a button to "Login with hCaptcha" that redirects to hCaptcha site, click login, redirect back with some token and let hCaptcha register the site and generate the keys itself. Pretty much like Google Site Kit works. Also not a fan that the inline styles include compatibility for plugins that I don't have enabled, such as #wpforo, #af-wrapper, .gform-*, .wpdm-*, .w3eden, .elementor-*, etc, but it's not the end of the world. I think I also had an issue with CF7 that it appended hCaptcha to the form even though I had added it manually with the hcaptcha shortcode. I have it enabled under Integrations but for some forms I may need to tweak the location so I added it manually there. Looking at the source, maybe I needed to use [[cf7-hcaptcha]], so my bad, but maybe it could be added to CF7 form editor "media_buttons" row to remember what it is. Also maybe the function hcap_get_error_messages() could have a filter or plugin options to change the 3 main plugin messages. I know I could contribute a translation to the plugin but you need like permissions first and then you gotta translate a major chunk of the plugin and get it reviewed and ideally maintain it, a lot of hassle for just changing the "Please complete the hCaptcha." message. gettext filter applies to every single translatable string ever so I'm hesitant to use it for performance reasons or maybe it's fine I don't know. Anyway, sorry for wall of text, 5 stars, thanks and keep it up!
April 1, 2023
using hcaptcha on another website is a chore. It hardly works, asking the most stupid questions like "a slow moving car" or "dog on a t-shirt." and even when it goes through, verification fails for must obscure reasons. maybe you'll prefer to use it for your website, but in the long run, it'll just end up driving potential clients away.
Read all 34 reviews

Contributors & Developers

“hCaptcha for WordPress” is open source software. The following people have contributed to this plugin.


“hCaptcha for WordPress” has been translated into 8 locales. Thank you to the translators for their contributions.

Translate “hCaptcha for WordPress” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Tested with WooCommerce 7.7.
  • Added general ability to turn off hCaptcha on a specific form.
  • Added filter hcap_protect_form, allowing to filter the protection status of a specific form.
  • Added support to turn off hCaptcha on a specific WordPress Core form.
  • Added support to turn off hCaptcha on a specific WooCommerce form.
  • Added support to turn off hCaptcha on a specific Gravity Form.
  • Added support to turn off hCaptcha on a specific Divi form.
  • Fixed error processing during plugin activation.
  • Fixed issue with invisible hCaptcha in Fluent Forms.
  • Fixed multiple issues related to Fluent Forms.
  • Fixed login issue with invisible hCaptcha on WooCommerce /my-account page.
  • Fixed Divi login form.


  • Tested with WooCommerce 7.5.
  • Added size argument to the shortcode.
  • Added compatibility with 3rd-party login plugins.
  • Added autocomplete=”off” attribute to the Secret Key field to prevent its autocompleting by the browser.
  • Added ‘hcap_error_messages’ filter allowing to modify hCaptcha error messages.
  • Changed position of hCaptcha widget on WooCommerce Place Order button.
  • Fixed uncaught type error during the login with PHP 8.0.


  • Tested with WordPress 6.2.
  • Tested with WooCommerce 7.4.
  • Added compatibility with Asgaros Forum.
  • Added compatibility with Support Candy.
  • Added Login Form support for MemberPress.
  • Added compatibility with GiveWP.
  • Added compatibility with Brizy.
  • Added activation and deactivation of plugins from the Integrations admin page.
  • Fixed error during login with WordPress < 5.4.


  • Fixed fatal error with WordPress < 6.1.


  • Tested with WooCommerce 7.3.
  • Added ability to use the HTMl tag ‘Submit’ in the Contact Form 7.
  • Added compatibility with ACF Extended Pro Form.
  • Added login attempts limit to Beaver Builder login form.
  • Added login attempts limit to Divi login form.
  • Added login attempts limit to Ultimate Member login form.
  • Added login attempts limit to WooCommerce login form.
  • Added optimisation of autoloading to boost performance.
  • Added block of launching recaptcha scripts by wpDiscuz.
  • Fixed showing the hCaptcha widget on wpForo community page.
  • Fixed PHP notice on the General settings page.
  • Fixed bug with number of login attempts before showing the hCaptcha.


  • Tested with PHP 8.2.
  • Plugin now requires WP 5.0.
  • Added script loading delay time setting.
  • Added compatibility with Otter Blocks Forms.
  • Added compatibility with ACF Extended Form.
  • Added compatibility with Kadence Form.
  • Added compatibility with wpDiscuz.
  • Added ability to show hCaptcha after certain number of failed logins.
  • Fixed hCaptcha placement in Avada form.


  • Tested with WooCommerce 7.2.
  • Added compatibility with WC High-Performance order storage (COT) feature.
  • Added compatibility with Contact Form 7 v5.7.


  • Added Avada theme support.
  • Added Beaver Builder support.
  • Added compatibility with Wordfence login security.
  • Improved spam protection with Contact Form 7.
  • Fixed fatal error in standard login form with Ultimate Member active.
  • Fixed fatal error with Jetpack sync.


  • Tested with WooCommerce 7.1.
  • Added Forminator support.
  • Added Quform support.
  • Added Sendinblue support.
  • Added Download Manager support.
  • Added support for password protected post/page.
  • Added actual messages from hcaptcha.com.
  • Added support for Multipage Gravity Form.
  • Fixed error messaging in Ninja Forms.
  • Fixed ‘hcaptcha is not defined’ issue with Elementor.


  • Tested with WordPress 6.1.
  • Tested with WooCommerce 7.0.
  • Added Settings page with multiple tabs.
  • Added setting for whitelisted IPs.
  • Added ability to set options network-wide on multisite.
  • Fixed Divi contact form bug related to recaptcha compat.
  • Fixed bug with WC Wishlist create list form.
  • Fixed styles on WordPress Register page.
  • Fixed shifting of hCaptcha layout during load.
  • Fixed Contact Form hcaptcha invalidation messages.


  • Fixed grey left sidebar issue on Elementor edit page.


  • Tested with WooCommerce 6.8.
  • Added Divi Comment Form support.
  • Fixed WPForms Login form support.
  • Fixed not valid CSS to prevent a black box issue.
  • Fixed invalid hCaptcha error after correction of wrong input on Checkout page.
  • Fixed hCaptcha functionality on Elementor Pro edit page when hCaptcha is off for logged-in users.


  • Tested with WooCommerce 6.6.
  • Added support for Ultimate Member plugin (Login, Register, LostPassword forms).
  • Fixed weird black bordered rectangle to the left of hCaptcha challenge.


  • Tested with WordPress 6.0.
  • Tested with WooCommerce 6.5.


  • Tested with WooCommerce 6.4.
  • Added Gravity Forms support.
  • Added filter to whitelist IPs.
  • Added support for multiple Ninja forms on a single page.


  • Tested with WooCommerce 6.2.
  • Added support for PHP 8.1.
  • Added support for Divi Login form.
  • Added hCaptcha language filter.
  • Changed nonce verification. Now nonce is verified for logged-in users only.


  • Tested with WooCommerce 6.1.
  • Added support for hCaptcha in Elementor Popup.
  • Fixed WooCommerce login when hCaptcha for WP login is active.
  • Fixed issue with Safari version < 14.


  • Tested with WodPress 5.9 and WooCommerce 6.0.
  • Added support for WP Fluent Forms.
  • Fixed regex for non-standard Order Tracking form.


  • Added support for non-standard WC Order Tracking form.
  • Fixed fatal error with Elementor Pro 3.5.


  • Fixed Divi Contact form in frontend builder.
  • Fixed WooCommerce login form.
  • Fixed css and js to pass W3C validation.
  • Fixed issue with Safari and invisible hCaptcha on auto-verify form.
  • Fixed issue with login via XML-RPC.


  • Added support for Divi Contact form.
  • Added support for Elementor Pro form.
  • Added support for MemberPress Register form.
  • Added support for WooCommerce Order Tracking form.
  • Fixed layout on the WP login form.
  • Fixed issue with insertion of hCaptcha not only to Jetpack forms.
  • Fixed regex bug in auto verify feature, which prevented registering of forms.


  • Added Invisible hCaptcha feature.
  • Added delayed rendering of hCaptcha to improve Google PageSpeed Insights score.
  • hCaptcha moved inside of Jetpack block form, before submit button.
  • Fixed fatal error with Divi theme.
  • Fixed – only 1 Contact Form 7 was working on the page.
  • Nonce is now checked with Contact Form 7.


  • Added auto-verification of an arbitrary form.


  • Fixed issue with Ninja Forms – hCaptcha is not shown.
  • Tested with WordPress 5.8 and WooCommerce 5.5


  • Fixed issue with CF7 – hCaptcha is not shown.


  • Fixed issue with WC login form when WP login form option is on.
  • Added feature to turn off the plugin for logged-in users.
  • Added hook to disable the plugin on specific pages.
  • Added feature to run hCaptcha script and styles on pages where it is used only.


  • Fixed issue with WooCommerce on my-account page – hCaptcha was requested even if solved properly.


  • Fixed issue with Contact Form 7 – reset hCaptcha widget when form is not validated.


  • Tested with WordPress 5.7 and WooCommerce 5.0


  • Added option to disable reCAPTCHA Compatibility (use if including both hCaptcha and reCAPTCHA on the same page)


  • 100% covered by WordPress integration tests.
  • Tests run on CI with PHP 5.6 – 8.0, the latest WordPress core and latest related plugins.


  • Make any Jetpack contact form working with Block Editor
  • Tested with WooCommerce 4.7


  • Don’t require challenge for admin comment reply


  • WPForms Pro support


  • WPCS coding standards and docs update


  • Tested with WordPress 5.5 and WooCommerce 4.4


  • Added WPForms Lite support


  • WooCommerce Wishlists bug fix
  • text domain updated: better i18n support


  • CF7 bug fix: enforce validation


  • Update docs


  • Refactor to improve code hygiene, fixes for latest Ninja Forms.


  • Fixed comment issue, added WooCommerce Wishlists


  • Updated testing information, improve docs.


  • Automatic addition of hCaptcha button to Contact Form 7 forms when enabled.


  • Update to Contact Form 7 support. Adds compatibility for version 5.1.3.


  • Minor bugfixes


  • Plugin Created