--- title: "Add hCaptcha to your Form - Convert Forms" description: "hCaptcha can protect your forms from bots, spam, and other forms of automated abuse. hCaptcha is a drop-in replacement for reCAPTCHA that pays websit" url: "https://www.tassos.gr/docs/convert-forms/security/hcaptcha-to-your-form" date: "2026-04-30T10:35:52+00:00" language: "en-GB" --- [ Home ](https://www.tassos.gr/index.php?option=com_content&view=category&layout=blog&id=24&Itemid=1088) / [ Convert Forms ](https://www.tassos.gr/index.php?option=com_content&view=category&id=43) / [ Spam, Security & Compliance ](https://www.tassos.gr/index.php?option=com_content&view=category&id=78) # Add hCaptcha to your Form hCaptcha can protect your forms from bots, spam, and other forms of automated abuse. hCaptcha is a drop-in replacement for reCAPTCHA that pays website owners while preserving user privacy by protecting user privacy, rewarding websites, and helping companies get their data labeled ![convert forms hcapatcha preview](https://www.tassos.gr/images/cf-hcaptcha-form-preview.png) hCaptcha is easy to be used, provides a variety of styles, supports both checkbox and invisible modes, and you can configure it with just a few steps. - [Generate hCaptcha Keys](#generate_keys) - [Add Checkbox hCaptcha to Joomla Forms](#add_checkbox_hcaptcha) - [Add Invisible hCaptcha to Joomla Forms](#add_invisible_hcaptcha) - [Why you probably don’t need hCaptcha](#honeypot) ## [Generate hCaptcha Keys](#generate_keys) To generate the required keys, you will have to login into your hCaptcha account by visiting the link: Login with either Github, Google, your own credentials or if you do not have an account, you can click on "Sign up" to create one. ![convert forms hcapatcha login](https://www.tassos.gr/images/cf-hcaptcha-login.png) After logging in, you will have to click on the *Sites* button on the top right of the page and then on *Add Site*. [![convert forms hcaptcha add new site](https://www.tassos.gr/images/cf-hcaptcha-add-site.png)](https://www.tassos.gr/images/cf-hcaptcha-add-site.png) You will be redirected to a page where you can enter your site's information and get your key. [![convert forms hcaptcha site settings 1](https://www.tassos.gr/images/cf-hcaptcha-site-settings1.png)](https://www.tassos.gr/images/cf-hcaptcha-site-settings1.png) [![convert forms hcaptcha site settings 2](https://www.tassos.gr/images/cf-hcaptcha-site-settings2.png)](https://www.tassos.gr/images/cf-hcaptcha-site-settings2.png) 1. Enter your site's name. 2. Enter your site's hostname. 3. Select the hCaptcha mode. (Note: **Passive** and **99.9% Passive** modes are only available to hCaptcha Pro users) 4. Select the challenge difficulty. 5. Click on the *Save* button. Your Site Key is ready! You can find it in the *Sites* page and copy it by clicking on it. [![convert forms hcaptcha site key](https://www.tassos.gr/images/cf-hcaptcha-site-key.png)](https://www.tassos.gr/images/cf-hcaptcha-site-key.png) #### [Get your Secret key.](#get-your-secret-key) Apart from the Site Key you just created, you also need the Secret key to enable the service. To get your Secret key, click on your profile icon at the top right of your dashboard and then on *Settings*. You will be redirected to the *Secrets* page where you can click on *Generate New Secret* to get your account's Secret Key. The key will be presented only once so make sure to copy it. [![convert forms hcaptcha secret key](https://www.tassos.gr/images/cf-hcaptcha-secret1.png)](https://www.tassos.gr/images/cf-hcaptcha-secret1.png) [![convert forms hcaptcha secret key](https://www.tassos.gr/images/cf-hcaptcha-secret2.png)](https://www.tassos.gr/images/cf-hcaptcha-secret2.png) ## [Add Checkbox hCaptcha to Joomla Forms](#add_checkbox_hcaptcha) The checkbox version requires the user to click a checkbox indicating the user is not a robot. This will challenge the user to validate whether or not they are human. ### [Add Checkbox hCaptcha Field to your form](#add_hcapatcha_to_form) In Joomla administration environment click on Global Configuration -> Convert Forms and click on the "hCaptcha" tab. [![convert forms hcaptcha configuration add keys](https://www.tassos.gr/images/cf-hcaptcha-fill-keys.png)](https://www.tassos.gr/images/cf-hcaptcha-fill-keys.png) Here is where your keys must be placed. Fill in both "Site key" and "Secret key" fields using the corresponding keys that hCaptcha has provided you. Next, go to the main administration menu: Components -> Convert Forms -> Forms. ![convert forms select forms](https://www.tassos.gr/images/convertforms_recaptcha_component_menu.png) And choose the form you want to edit. ![convert forms select a form](https://www.tassos.gr/images/cf-recaptcha-sample-form-select.png) Choose the tab "Add Field" and click on the *hCaptcha* field in the Advanced Fields category. Save your work. [![convert forms select hcaptcha field](https://www.tassos.gr/images/cf-hcaptcha-sample-form-select.png)](https://www.tassos.gr/images/cf-hcaptcha-sample-form-select.png) Subsequently, more options about appearance are given where you can optionally choose the hCaptcha type, theme, and size in the respective field options. [![convert forms hcaptcha field settings](https://www.tassos.gr/images/cf-hcaptcha-sample-form-settings.png)](https://www.tassos.gr/images/cf-hcaptcha-sample-form-settings.png) hCaptcha comes with the Light and Dark themes and in a Normal and Compact size as you can see in the screenshot below: ![convert forms hcaptcha themes](https://www.tassos.gr/images/convertforms_hcaptcha_themes.png) Finally, after all the changes save your work. Your hCaptcha field is ready! ## [Add Invisible hCaptcha to Joomla Forms](#add_invisible_hcaptcha) The invisible hCaptcha does not require the user to click on a checkbox, instead it will display a challenge to the user when a user submits your form. The Site Key and Secret Key can be generated via the above guide by clicking [here](#generate_keys). ### [Add Invisible hCaptcha Field to your form](#add_invisible_hcapatcha_to_form) Follow the steps listed [here](#add_hcapatcha_to_form) to add your hCaptcha to your form. You should now select "Invisible" under the "Type" setting. ![convert forms hcaptcha invisible select](https://www.tassos.gr/images/convertforms_hcaptcha_invisible_select.png) Finally, after all the changes save your work. Your hCaptcha Invisible field is ready! ## [Why you probably don’t need hCaptcha](#honeypot) Without you having to do a thing, Convert Forms is already protecting your forms from spam submissions. A honeypot field is automatically added to each form by default. It's designed to catch spammers in the same way an actual pot of honey would catch flies. It's just a hidden field placed into every form and it's purpose is to make form submission fail if anything is entered into it. Read more here: [Native Convert Forms Anti-spam Protection with Honeypot](https://www.tassos.gr/joomla-extensions/convert-forms/docs/native-convert-forms-anti-spam-protection-with-honeypot) **Tips:** - Don’t forget to store your keys. Last updated on Feb 4th 2025 01:02 ## Schema ```json { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.tassos.gr" }, { "@type": "ListItem", "position": 2, "name": "Home", "item": "https://www.tassos.gr/docs" }, { "@type": "ListItem", "position": 3, "name": "Convert Forms", "item": "https://www.tassos.gr/docs/convert-forms" }, { "@type": "ListItem", "position": 4, "name": "Spam, Security & Compliance", "item": "https://www.tassos.gr/docs/convert-forms/security" }, { "@type": "ListItem", "position": 5, "name": "Add hCaptcha to your Form", "item": "https://www.tassos.gr/docs/convert-forms/security/hcaptcha-to-your-form" } ] } ``` ```json { "@context": "https://schema.org", "@type": "Article", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://www.tassos.gr/docs/convert-forms/security/hcaptcha-to-your-form" }, "headline": "Add hCaptcha to your Form", "image": { "@type": "ImageObject", "url": "https://www.tassos.gr/" }, "publisher": { "@type": "Organization", "name": "Tassos", "logo": { "@type": "ImageObject", "url": "https://www.tassos.gr/https://www.tassos.gr/media/brand/logo-text.png" } }, "author": { "@type": "Person", "name": "Tassos Marinos", "url": "https://www.tassos.gr/docs/convert-forms/security/hcaptcha-to-your-form" }, "datePublished": "2018-07-27T09:32:35+03:00", "dateCreated": "2021-04-01T13:57:52+03:00", "dateModified": "2025-02-04T01:03:16+02:00" } ```