# Enabling Google reCAPTCHA v3

> For the complete documentation index, see [llms.txt](/llms.txt)

> Add invisible bot protection to your feedback widget with Google reCAPTCHA v3. It runs in the background without interrupting your users.

Add invisible bot protection to your feedback widget with Google reCAPTCHA v3. It runs in the background without interrupting your users.

## Get your reCAPTCHA keys

1. Visit the [reCAPTCHA Admin Console](https://www.google.com/recaptcha/admin) and sign in.
2. Click **+** to register a new site.
3. Select **reCAPTCHA v3** as the type.
4. Add your domain(s) without `https://` (e.g., `docs.example.com`).
5. Submit and copy both the **Site Key** and **Secret Key**.

## Enable in your project

1. Go to your project in the [PushFeedback dashboard](https://app.pushfeedback.com).
2. Click **Settings** and find the **Security** section.
3. Enable reCAPTCHA v3 and paste both keys.
4. Set the minimum score (default 0.5 works for most sites).
5. Save.

![reCAPTCHA v3 settings in the Security section](./images/recaptcha.png)

Your widget will now verify submissions automatically. No code changes needed.

## Adjusting the score threshold

reCAPTCHA scores range from 0.0 (bot) to 1.0 (human). Start with 0.5 and adjust:

- **Getting spam?** Increase to 0.6-0.7
- **Blocking real users?** Decrease to 0.3-0.4

## Notes

- Your secret key is encrypted before storage.
- HTTPS is required (localhost works for testing).
- The reCAPTCHA badge is hidden, and the required Google disclosure text is automatically displayed in the widget footer.
- You can customize the disclosure text using the `recaptchaText` prop (see [Layout customization](../customization/layout)).

## Troubleshooting

- **"reCAPTCHA verification required"** - Ad blockers or privacy extensions may be blocking the script. Ask users to disable them temporarily.

- **"reCAPTCHA verification failed"** - Check your keys are correct and your domain is registered in Google's console. If legitimate users are blocked, lower your score threshold.

- **General issues** - Verify you selected reCAPTCHA v3 (not v2) and both keys are from the same site registration.