django-anymail

What it is and what it does

Django-anymail is a Django email backend that abstracts away the differences between transactional email service providers (ESPs) like Mailgun, SendGrid, Amazon SES, Postmark, and others. Instead of writing code tied to one ESP's API, you configure Anymail to use your chosen provider and then use Django's standard email functions—send_mail, EmailMessage, EmailMultiAlternatives—which Anymail routes through that provider's API. It extends Django's built-in email with ESP-specific features like tags, metadata, click tracking, and inline images, while keeping your code portable so you can switch providers later without rewriting.

Anymail also handles receiving email through ESP webhooks, normalizing inbound messages into a consistent format, and converting ESP tracking notifications (bounces, opens, clicks) into Django signals. It supports batch transactional sends using template and merge features, full Unicode support, and simplified attachment handling. The package is actively maintained, compatible with Django 5.0–6.0 and Python 3.10–3.14, and has no known security vulnerabilities.

Use it for

• Send transactional emails (password resets, order confirmations) through a reliable ESP without hardcoding a specific provider's API.
• Track email opens, clicks, and bounces by receiving ESP webhooks and converting them to Django signals for analytics.
• Switch email providers (e.g., from Mailgun to SendGrid) by changing one configuration line instead of rewriting email code.
• Send templated batch emails with merge variables using your ESP's native template engine for performance.
• Receive inbound email through an ESP's webhook and process attachments and headers in a normalized, portable way.
• Add metadata and tags to sent emails for segmentation and debugging without writing provider-specific code.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

django-anymail on PyPI

Before you install

Low install friction with a pure-Python wheel. Active maintenance with a recent release (15 days old) and steady repository activity. Supports current Python versions (3.10–3.14) and modern Django releases (5.0–6.0).

Requires Django 5.0 or later (or earlier versions with EMAIL_BACKEND configuration); each ESP may require its own API credentials.

License in practice

BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install django-anymail[mailgun]

# In settings.py (Django 6.1+):
INSTALLED_APPS = ["anymail"]
MAILERS = {
    "default": {
        "BACKEND": "anymail.backends.mailgun.EmailBackend",
        "OPTIONS": {"api_key": "", "sender_domain": "mg.example.com"},
    }
}

# Then use Django's standard email:
from django.core.mail import send_mail
send_mail("Subject", "Body", "from@example.com", ["to@example.com"])

Package facts

Evidence: django_anymail-15.1-py3-none-any.whl

Tags

More Python Modules packages

See also django-templated-email · mailgun · mailtrap · repoze-sendmail · django-ses · django-sendgrid-v5 · sparkpost · mailjet-rest · django-post_office · dj-email-url