---
updatedAt: 2026-08-27T23:13:28.000Z
agentTools:
  projectIndex: https://docs.wristband.dev/llms.txt
---

# Bot Detection

Protect your application from automated attacks with built-in CAPTCHA enforcement.

Wristband integrates with Google reCAPTCHA to detect and block automated bot activity. When active, Google reCAPTCHA evaluates each request using risk scoring and may present users with a CAPTCHA challenge if the request appears suspicious. This helps protect against credential stuffing, brute force attacks, and other bot-driven threats.

<Callout icon="ℹ️" theme="info">
  **Note:** Bot detection only applies to Wristband-hosted UI pages. Self-hosted UI pages are not protected by Wristband's CAPTCHA enforcement. Bot protection for self-hosted pages is the responsibility of the application.
</Callout>

***

## Protected Pages

CAPTCHA is enforced on the following Wristband-hosted pages:

* Application-level Login Page (Tenant Discovery)
* Tenant-level Login Page
* Application-level Signup Page
* Tenant-level Signup Page

Signup pages always enforce CAPTCHA regardless of policy configuration. Login pages enforce CAPTCHA based on configured Bot Detection Policies. Other Wristband-hosted pages (such as email-based workflow pages and External IdP pages) are protected by auth code JWTs rather than CAPTCHA.

<br />

***

<br />

## Bot Detection Policies

Bot Detection Policies control CAPTCHA enforcement for your application. They are configured under **Security → Bot Detection Policies** in the Application View of the Wristband Dashboard.

* **Login CAPTCHA Enforcement Strategy:** Controls whether users are required to complete a CAPTCHA challenge on login pages. Can be set to always enforce or never enforce. Does not affect signup pages, which always enforce CAPTCHA.

<Callout icon="ℹ️" theme="info">
  **Note:** CAPTCHA cannot be disabled at the application level for Production applications, though non-Production applications can disable it for testing.
</Callout>

<Image src="https://files.readme.io/8542f072be00888a67da6d1f8cb944b2c311e68556193d8a257b3943ba06fabb-Screenshot_2026-07-01_at_11.59.40_PM.png" align="center" width="700px" caption="The Bot Detection Policies page in Application View for a Production application." />

<br />

Tenants can override the application-level policy from their own **Security → Bot Detection Policies** page in Tenant View, disabling CAPTCHA enforcement for that tenant's login page, regardless of environment.

<Image src="https://files.readme.io/ba61736bcc12640416ca2b96cc92dddde21b0f0ea724eeb61dbd30e49c7fce8e-Screenshot_2026-08-27_at_4.11.29_PM.png" alt="bot-detection-policies-tenant-override" align="center" width="700px" caption="The Bot Detection Policies page in Tenant View, showing the tenant override toggle and the tenant-level CAPTCHA enforcement setting." />

<br />

<HTMLBlock>{`
<style>
.UpdatedAt {
  display: none;
}
</style>
`}</HTMLBlock>