# reCAPTCHA Bot Protection

Bots can disrupt your checkout process by submitting fake orders, leading to operational issues and fraud risks. To prevent this, Limio supports Google reCAPTCHA, a widely used security measure that helps ensure only real users can proceed.

This guide will walk you through enabling, configuring, and customizing reCAPTCHA in your Limio checkout to balance security and user experience.

For more on strengthening checkout security, see [Limio Security Best Practices](https://docs.limio.com/integrations/using-limio-for-salesforce/address-mandatory-fields#best-practices).

### Enabling reCAPTCHA in Limio

Follow these steps to enable reCAPTCHA in your checkout flow:

1. Generate reCAPTCHA credentials:
   * Go to [Google reCAPTCHA Admin Console](https://www.google.com/recaptcha).
   * Register your site and select reCAPTCHA v3.
   * Copy the **site key** and **secret key** provided.
2. Configure reCAPTCHA in Limio:
   * Navigate to **settings > site security** in the Limio Admin Panel.
   * Locate the **reCAPTCHA configuration** section.
   * Enter your **site key** and **secret key**.
   * Choose the reCAPTCHA version you registered.
   * Click **save** to apply the changes.
3. Rebuild Pages in Limio:
   * Navigate to **catalog > operations > mass build and publish** in the Limio Admin Panel.
   * In the Label dropdown select 'Show All'
   * Click 'Mass-Build'
   * Once the build has completed
   * Click 'Mass-Publish'
4. Test the Integration:
   * Perform a test checkout to verify that reCAPTCHA appears as expected.
   * Check your Google reCAPTCHA dashboard for validation logs.

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

### 📷 *Screenshot: Site security settings*

### Customizing reCAPTCHA behaviour

Limio provides options to customize reCAPTCHA settings to balance security and user experience:

* **Threshold settings (for reCAPTCHA v3)**: Adjust the sensitivity level to filter bot activity.
* **Page placement**: Configure whether reCAPTCHA appears on the cart page, checkout page, or both.
* **User experience settings**: Enable options like "Remember me" to reduce friction for returning customers.

### Troubleshooting

If reCAPTCHA is not functioning correctly:

* **Ensure correct API keys**: Double-check your Site Key and Secret Key.
* **Browser console errors**: Check for JavaScript errors in the browser developer console.
* **Google Dashboard**: Review your Google reCAPTCHA admin panel for blocked requests or misconfigurations.
* **Contact Support**: If the issue persists, reach out to Limio Support for assistance.


---

# 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.limio.com/product/settings/security/recaptcha-bot-protection.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.