Skip to main content

A simple and customizable email template built for Django

Project description

django-simple-mail v2.0.0 on PyPi MIT license Stable


Simple customizable email template built for Django


These Django app works with :

  • Python (>=2.7) (Need to be tested for 3.x)
  • Django (>=1.9) (Need to be tested for previous versions)


Install using pip :

pip install django_simple_mail

Add simple_mail and solo to your INSTALLED_APPS setting.


Then run :

python makemigrations python migrate

Register mails

Create a file in your app and define your mail :

from simple_mail.mailer import BaseSimpleMail, simple_mailer

class WelcomeMail(BaseSimpleMail):
    email_key = 'welcome'


Then run ./ register_mails to create those mail into the database.

Send an email

You can the send the WelcomeEmail the following way :

welcome_email = WelcomeEmail()
welcome_email.set_context(args, kwargs)
welcome_email.send(to, from_email=None, bcc=[], connection=None, attachments=[],
                   headers={}, cc=[], reply_to=[], fail_silently=False)

Preview and customization:

The default mail template is built with Cerberus and looks like this with placeholder values:

Email Preview

Email Preview

Django Admin

You can customize the colors and base content of your template directly inside the admin.

You can manage your emails and their content directly from django admin :

Admin Preview

Admin Preview

You can also use variables inside the fields to make your content more dynamic :

Admin Preview

Admin Preview


If you are having issues, please let us know or submit a pull request.


The project is licensed under the MIT License.

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django_simple_mail-2.0.0-py2.py3-none-any.whl (16.0 kB) Copy SHA256 hash SHA256 Wheel py2.py3
django_simple_mail-2.0.0.tar.gz (14.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page