> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/app-integration/hcaptcha-integration.md).

# hCaptcha integration

**✅ What You Need**

Before enabling hCaptcha, you need two keys:

* **Site Key**
* **Secret Key**

You can get both keys from your hCaptcha account.

Create an account or log in here: <https://www.hcaptcha.com/>

***

### 📝 Step 1: Get Your hCaptcha Site key and Secret Key

1. Sign up or log in to the [hCaptcha Dashboard](https://dashboard.hcaptcha.com/)
2. Go to the **Sites** tab in the dashboard and create a new sitekey

<figure><img src="/files/i0Pxt4MvIBtqGwWhgqIl" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ioZ6QW9MN6TZkLydRXxG" alt=""><figcaption></figcaption></figure>

3. Go to the **Settings** tab in the dashboard and generate your secret key by clicking **Generate New Secret**

<figure><img src="/files/zZ2cmaUrP7J4F9GmFCxA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5Lx1x7ruQtlgjSecZcOS" alt=""><figcaption></figcaption></figure>

You now have:

* Site key&#x20;
* Secret key&#x20;

***

### 📝 Step 2: Add the Keys to Powerful Form Builder

1. Open the form app > go to app **Settings** > hover on hcaptcha option
2. Paste the site **Site key** and **Secret key** from step 1 into the fields
3. Click **Save** to store your settings

<figure><img src="/files/hUIa55kh9AFPlHvIsn96" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 3: Enable hcaptcha for  the form

1. In the app > click **Forms** > open the form
2. Click **Integration**, toggle on the **Captcha** option > click on the **Captcha** option to view detail >  choose **hCaptcha**.
3. Save the form
4. Note: Verify the hCaptcha widget in the **live store**, as it may not display in the app preview.

<figure><img src="/files/zb4JmgYFYC8KquSKGSXg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wZI26dFyyAH7BXPiCTwA" alt=""><figcaption></figcaption></figure>

***

### 🛡️ How hCaptcha Works

hCaptcha protects your form by identifying humans vs bots.

#### ✔ Visible hCaptcha (checkbox or image challenge)

* Users must solve a simple verification (like selecting images).
* hCaptcha decides if the user is human before allowing submission.

#### ✔ Invisible hCaptcha (runs quietly in the background)

* No clicking, no challenge.
* hCaptcha analyzes user behavior silently.
* Only shows a challenge if activity looks suspicious.

Your form is protected in both cases.

***

### 🔧 Troubleshooting

#### ❌ Issue: hCaptcha not showing

Try the following:

* Double-check your **Site Key** and **Secret Key**
* Make sure your **Shopify domain** is added in your hCaptcha dashboard
* Clear browser cache or test in Incognito mode
* Ensure the form is **published** and you’re on the correct page

#### ❌ Issue: Form cannot be submitted

Common causes:

* Incorrect Secret Key
* Incorrect domain
* Key fields accidentally left blank
* Theme scripts blocking the widget (rare)

***

#### Need More Help?

If you still need assistance, please contact us at <contact@globo.io>. Our team will be happy to help you resolve any issues or guide you further.