> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipedform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# hCaptcha

Protect your forms from spam and bot submissions by integrating hCaptcha, a privacy-focused, drop-in captcha solution that verifies your form is being submitted by a real person.

Bots and automated spam can quickly fill your inbox with junk submissions. This guide walks you through integrating hCaptcha into your form, so only real users get through.

<Note>
  hCaptcha integration is available on the **Paid** plan.
</Note>

## Setting Up hCaptcha

Follow these steps to add hCaptcha protection to your form.

<Steps>
  <Step title="Get Your hCaptcha Keys">
    Sign up for a free account at [hcaptcha.com](https://www.hcaptcha.com/) then create a new site to get your **Site Key** and **Secret Key**.
  </Step>

  <Step title="Enable hCaptcha in Your Form Settings">
    Go to your form's Settings page, add **hCaptcha Protection**, and paste in your **Secret Key**. PipedForm will use this to verify submissions on the server side.
  </Step>

  <Step title="Add the hCaptcha Widget to Your Form">
    Add the hCaptcha script to the `<head>` section of your page:

    ```html theme={null}
    <script src="https://js.hcaptcha.com/1/api.js" async defer></script>
    ```

    Add the widget inside your form using your **Site Key** (replace `your-site-key`):

    ```html theme={null}
    <form action="https://pipedform.com/f/{form_id}" method="POST">
      <!-- ... -->
      <div class="h-captcha" data-sitekey="your-site-key"></div>
      <!-- ... -->
    </form>
    ```
  </Step>

  <Step title="Test Your Form">
    Submit a test entry through your form. If the hCaptcha challenge isn't completed, PipedForm will reject the submission.
  </Step>
</Steps>

For more advanced configuration options, such as customizing the widget's size, theme, or language, refer to the [official hCaptcha documentation](https://docs.hcaptcha.com/).

<Warning>
  **Notes:**

  * Both the **Site Key** (used in your form) and **Secret Key** (used in your form settings) are required for hCaptcha to work.
  * If hCaptcha is enabled but the widget is missing from your form, all submissions will be rejected.
</Warning>
