How to switch from reCAPTCHA to hCaptcha

Switching from reCAPTCHA to hCaptcha is easy. Below you can find a step-by-step process to help you with this switch.


Note: You don't have to update your callbacks or tag attributes.

Get your hCaptcha's sitekey & secret keys pairs

Signup/login to
Go to the sites tab in the dashboard and create a new sitekey.
Go to the settings tab in the dashboard and copy your secret key.

Update client side integration

1- Replace script

<script src="" async defer></script>


<script src="" async defer></script>

2- Replace parameter name

g-recaptcha becomes h-captcha

Update server side integration

1- Update secret key

Use the secret key that you got in the first step.

2- Replace parameter

g-recaptcha-response becomes h-captcha-response

3- Update siteverify url (or becomes

Switch from plugins/libraries

We already have a rich list of integrations with other platforms/frameworks:

Platform/Framework Link
ReactJS react-hcaptcha
Angular ng-hcaptcha
Express.js express-hcaptcha
Node.js node-hcaptcha
VueJS vue-hcaptcha
WordPress plugin hcaptcha-wordpress-plugin
Android Use hCaptcha with Android Apps
PHP Use hCaptcha with PHP Apps