# 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FTkF2UWTZY9YdQU7sZXRx%2Fimage.png?alt=media&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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%2FdaUOSY5eHtP3g5E3tE3Y%2F2026-01-30_14-19-54.png?alt=media&#x26;token=fa294572-d744-4bfc-b0f3-1dada61c2b6c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FQwzvXl9DPuHglofE0dAX%2F2026-01-30_14-20-10.png?alt=media&#x26;token=2d247d3b-c07a-486b-9c5e-8b7ccbd284a9" 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 [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerfulform.com/app-integration/hcaptcha-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.