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

# Configuration

Once the extension is installed successfully, go to S**tores > Configuration > MageComp > hCaptcha** to configure the extension for use.

#### General

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

* **hCaptcha API website key and secret key -** Admin will be required to enter the website API key and Secret key, which they will get from hCaptcha.

#### Admin Panel

<figure><img src="/files/0RyKgbKIX34A6bOw87li" alt=""><figcaption></figcaption></figure>

* **Enable For Admin Pages -** Select Yes to enable hCaptcha for admin pages.
* **Applicable Pages -** Select admin pages to enable hCaptcha verification.

#### Frontend

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

* **Enable For Default Pages -** Select Yes to enable hCaptcha for various storefront pages.
* **Applicable Pages/Forms -** Select pages for which you want to enable hCaptcha verification.
* **Enable For Custom Forms -** Select Yes to enable hCaptcha for Custom Forms. Copy the given code and paste it into your CMS content to enable hCaptcha verification for custom forms.

#### hCaptcha Theme

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

* **Theme -** From here, the store owner can select their desired theme based on their website background color from the given Light Theme and Dark Theme options.
* **Size -** In this field, the admin can choose the size that best fits their website from the provided normal and compact options.
* **hCaptcha Preview -** It displays a preview based on the theme and size selection.

#### IP Whitelist Settings

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

* **Enable -** Select Yes to add IPs to the whitelist.
* **Whitelist IPs -** Add IP addresses separated by commas to skip hCaptcha verification.

**You Can Checkout Official hCaptcha Plugin Integration List From** [**Here**](https://github.com/hCaptcha/hcaptcha-integrations-list/pull/7)**!**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.magecomp.com/magento-2-hcaptcha/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
