Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Simple support/contact form for your Django app

Project Description

# django-support-form

[![Build Status](](
[![Coverage Status](](

Simple contact/support form for Django apps.

## Install

pip install django-support-form

## Setup

Add `supportform` to `INSTALLED_APPS` along with the following Django contrib apps:


Include the `supportform.urls` in the the `ROOT_URLCONF`:

from django.conf.urls import url, patterns, include

urlpatterns = patterns('',
url(r'^support/', include('supportform.urls')),

## Settings

- `SUPPORT_EMAIL` - The recipient email address the support email will be sent to, e.g. ''. Default is `DEFAULT_FROM_EMAIL` Django setting.
- `SUPPORT_EMAIL_SUBJECT` - Default email subject prepopulated in the support form. Default is 'Support Message'.
- `SUPPORT_WAIT_SEND` - Wait until the email successfully sends. If set to false, the email will be sent in the background (via a thread). Default `True`

## Templates

The templates that come with the django-supportform are functional, but _very_ minimal:

- `supportform/form.html` - Renders the support form omitting the email field is the user is logged in. On submission if the email fails to send, a fallback message will be display to send an email directly to `SUPPORT_EMAIL`.
- Context received:
- `form` - `SupportForm` instance
- `supportform/success.html` - Renders a static success/thank you page. This is the page redirected to after successfully sending a message.
- Context received: (none)

An email template is also provided and can be customized as well:

- `supportform/email_body.txt`
- Context recieved:
- `message` - Left by the user
- `request` - Request object
- `user` - If the message was left by an authenticated user

Release History

This version
History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(5.0 kB) Copy SHA256 Hash SHA256
Source Sep 11, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting