---
id: django-recaptcha
version: "4.1.0"
license: BSD
license_treatment: permissive
maintenance: active
---

# django-recaptcha — Django recaptcha form field/widget app.

License: permissive · Maintenance: active · Downloads: 654.1K/mo

## What it is and what it does

Django reCAPTCHA is a form field and widget integration for Google's reCAPTCHA service, protecting Django forms from automated bot submissions. It supports three reCAPTCHA versions: V2 Checkbox (user clicks a box), V2 Invisible (verification happens silently), and V3 (risk scoring based on user behavior). The package wraps Google's reCAPTCHA API and handles both client-side rendering and server-side validation, with configurable score thresholds for V3 and support for proxy settings and alternative domains.

You add it to a Django form by declaring a ReCaptchaField, configure your Google API keys in Django settings, and the widget renders the appropriate reCAPTCHA UI. It includes error translations for multiple languages and allows per-field key override and customization of widget appearance through data attributes and API parameters. The package has been maintained since 2010 and is actively developed.

Use it for:

- Protect user registration and login forms from automated account creation and credential stuffing attacks.
- Prevent spam submissions in contact forms, comment sections, and feedback forms on public websites.
- Use reCAPTCHA V3 scoring to flag suspicious form submissions for review without interrupting legitimate users.
- Implement invisible reCAPTCHA on checkout or payment forms to reduce friction while maintaining bot protection.
- Customize reCAPTCHA appearance (theme, size, language) to match your site's design and user base.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Google reCAPTCHA (V2 Checkbox, V2 Invisible, and V3) into Django forms as a field and widget for bot detection and form protection.

Yes. Django reCAPTCHA is a mature, actively maintained package with low install friction, no known vulnerabilities, and permissive licensing. It is the standard way to integrate Google reCAPTCHA into Django forms and is suitable for any Django project needing bot protection. Install it if you need to protect forms from automated abuse.

## Install

pip install django-recaptcha
uv add django-recaptcha
poetry add django-recaptcha

## Installing django-recaptcha

Before you install: Low install friction with a single runtime dependency on django. Actively maintained with recent commits and a stable release history since 2010; tested against Python 3.9–3.13 and Django 4.2–5.2.

License in practice: BSD permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install django-recaptcha

# In settings.py
INSTALLED_APPS = [..., 'django_recaptcha', ...]
RECAPTCHA_PUBLIC_KEY = 'your_public_key'
RECAPTCHA_PRIVATE_KEY = 'your_private_key'

# In forms.py
from django_recaptcha.fields import ReCaptchaField
class MyForm(forms.Form):
    captcha = ReCaptchaField()

Requires a Google reCAPTCHA account and API keys (public and private) obtained from Google's reCAPTCHA console.

Verify before relying:

- Whether the included modified reCAPTCHA client (client.py) is kept in sync with upstream recaptcha-client library updates.
- Performance impact of reCAPTCHA V3 score validation on form submission latency.
- Exact list of supported language codes beyond the documented es, fr, nl, pl, pt_BR, ru, zh_CN, zh_TW.

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 654.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django recaptcha form field, google recaptcha django integration, bot protection django forms, recaptcha v2 v3 django, django form validation captcha, recaptcha widget django, form spam protection django, form-security, bot-protection, django-integration

[View on SkillFed](https://skillfed.io/packages/django-recaptcha) · [View on PyPI](https://pypi.org/project/django-recaptcha/)