Skip to main content

A generic contact-form application for Django

Project description Documentation Status

This application provides simple, extensible contact-form functionality for Django sites.
  • Mail header ‘From: “Your Name” <>’, so it’s easy to reply to the sender.

  • Subject provided by the user.

  • Uses reCAPTCHA to block spam robots.

Quick start


  • Python (2.7, 3.4, 3.5, 3.6)

  • Django (1.11, 2.0)

To use the contact_forms.forms.ReCaptchaContactForm form:

  1. Install django-contact-form-recaptcha:

    pip install django-contact-form-recaptcha
  2. Obtain the reCAPTCHA API keys from

  3. Supply the API keys for django-contact-form-recaptcha to use. You can either place them in the Django settings RECAPTCHA_PUBLIC_KEY and RECAPTCHA_PRIVATE_KEY, or in the environment variables PYTHON_RECAPTCHA_PUBLIC_KEY and PYTHON_RECAPTCHA_PRIVATE_KEY.

  4. Add the application captcha in the Django settings:

  5. Then use the following URLconf:

    from django.conf.urls import include, url
    urlpatterns = [
        # ... other URL patterns for your site ...
        url(r'^contact/', include('contact_form.recaptcha_urls')),

    If you’re using Django 2.0, you can do:

    from django.urls import include, path
    urlpatterns = [
        # ... other URL patterns for your site ...
        path('contact/', include('contact_form.recaptcha_urls')),
  6. Create your templates in your templates directory:

    • contact_form/contact_form.html

    • contact_form/contact_form_sent.html

    • contact_form/contact_form.txt

    • contact_form/contact_form_subject.txt

    Or you can use the templates provided by this package. Remember to add the application contact_form in the Django settings.

  7. Emails are sent to the MANAGERS defined in your Django settings:

    MANAGERS = [('John', ''),]

Full documentation for all functionality is included and is also available online.

Originally forked from django-contact-form.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-contact-form-recaptcha-1.6.1.tar.gz (55.5 kB view hashes)

Uploaded Source

Built Distribution

django_contact_form_recaptcha-1.6.1-py2.py3-none-any.whl (24.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page