# Cloudflare Turnstile

Before you follow the steps below, make sure you have a Cloudflare Turnstile account. If you don't have one yet, you can register at the link below:

{% embed url="<https://dash.cloudflare.com/sign-up>" %}

There are 2 pieces of data you need to integrate Cloudflare Turnstile with the Shoppego system:

* Site key
* Secret key

## Settings on Cloudflare Turnstile

1. You can log in to your Cloudflare dashboard first.

<figure><img src="/files/88PyYDqTx9CQobeOYWFX" alt=""><figcaption></figcaption></figure>

2. Click on **Application security** and **Turnstile**

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

3. Then, you can click **Add widget**

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

4. Later, you will be able to see the settings you need to make. For "**Widget name**" you can enter a name text for your reference later.

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

5. Then, you need to set the Hostnames by clicking on the "**Add Hostnames**" button.

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

If you **do not have a hostname/domain set in your Cloudflare account**, you can **enter your hostname/domain in the Custom hostname section (Highlighted in yellow)**.\
\
If your **hostname/domain is already in your Cloudflare account**, you can **continue to make the selection as shown (Highlighted in green)**.\
\
Once done, click **Add**

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

6. Next, for the "**Widget Mode**" setting, you can set it to whatever you want. We recommend setting it to "**Invisible**".

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

7. Once finished, click **Create**

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

Now, you can see the "**Site key**" and "**Secret key**", which you need to enter in the settings on the Shoppego dashboard later.

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

## Setting up in Shoppego

1. Log in to your Shoppego account.

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

2. Click on **Settings**

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

3. Click on **Captcha providers**

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

4. Click on the **Activate/Edit** button for the provider type "**Cloudflare Turnstile**"

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

5. Then, you can **enter your Cloudflare Turnstile Site key** and **Secret key** in the spaces provided. Make sure to **tick the Enable toggle** and click **Save**

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

Now your setup is complete. You should be able to see the Cloudflare logo (If you are using "Widget mode" "Manage") displayed on the "Forms" page and also the "Login" page of your website.

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


---

# 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.shoppego.com/en/settings/captcha-providers/cloudflare-turnstile.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.
