> 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/~/revisions/KRfi0fHdeAFeAhiPrH7G/app-integration/hrecaptcha.md).

# hrecaptcha

Add an extra layer of spam protection to your forms with hCaptcha — a secure and privacy-focused alternative to Google reCAPTCHA.

**✅ 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FTkF2UWTZY9YdQU7sZXRx%2Fimage.png?alt=media&amp;token=df3496d5-6290-4f5a-8ac4-fe9e54c19f0e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F9WlJgIy4myAejLEv9zoi%2Fimage.png?alt=media&amp;token=afaa819f-f11a-40a7-abc3-d46fec9984bd" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FN7wmqcR756hRKOPz5fgq%2Fimage.png?alt=media&amp;token=8b453ed1-3b60-4aa3-afc3-e2b81d3dfe8b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FlL5j8JAU1TAu8cRKpYe7%2Fimage.png?alt=media&amp;token=3498607d-4014-4a72-a555-7e1c4036476a" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F5YoBcrjvk6AoEIKghatw%2F2025-09-10_15-35-01.png?alt=media&amp;token=e957551c-7c86-4e5e-adb4-0a6b6ba3250d" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FFfyhn6KHRAMTps08bE08%2F2025-09-10_15-41-54.png?alt=media&amp;token=31ec4b85-d5cc-42b8-ae36-8bc82d73948d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2Fmr8w4bgJIQjXapmhv1Yw%2F2025-09-10_15-42-55.png?alt=media&amp;token=570db278-99fe-4632-bef0-2d710a33ef8f" 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)

If none of these work, contact our support team:\
📧 **<support@powerfulform.com>**