How to Send Emails With Django

If you’re building a Django app and you want to connect with users – maybe to welcome them, send password reset links, or deliver updates – email is one of the best tools you’ve got.

Setting up email in Django might sound tricky at first, but it’s pretty straightforward once you get the hang of it.

I’ve walked a bunch of people through it, and by the end of this guide, you’ll feel confident about sending emails from your own Django projects.

Why Email Matters in Web Apps

Email isn’t just a nice-to-have – it’s essential for communication, trust, and user experience.

Think about it:

• How do you confirm someone’s account? Email.

• How do you help users reset a password? Email.

• Want to send updates, alerts, or custom reports? You guessed it – email.

That’s why it’s worth setting up properly.

What You’ll Learn in This Guide

Here’s what I’ll walk you through:

• How to set up email in Django

• How to choose between development and production settings

• How to send basic emails

• How to send HTML and multi-part emails

• How to use templates for emails

• Common mistakes to avoid

Let’s get into it.

How to Send Emails With Django

Here is how to get started.

Step 1: Configure Your Email Settings in Django

Django uses the EmailMessage class and the built-in send_mail function to send emails. But first, you have to tell Django how to connect to your email provider.

Open your settings.py file and add your email backend configuration.

Here’s an example using Gmail:

<span class="hljs-comment"># settings.py</span>

EMAIL_BACKEND = <span class="hljs-string">'django.core.mail.backends.smtp.EmailBackend'</span>
EMAIL_HOST = <span class="hljs-string">'smtp.gmail.com'</span>
EMAIL_PORT = <span class="hljs-number">587</span>
EMAIL_USE_TLS = <span class="hljs-literal">True</span>
EMAIL_HOST_USER = <span class="hljs-string">'your_email@gmail.com'</span>
EMAIL_HOST_PASSWORD = <span class="hljs-string">'your_app_password'</span>

Important: If you’re using Gmail, you’ll need to set up App Passwords because regular account passwords won’t work with SMTP anymore.

For Development

If you’re just testing emails locally and don’t want to actually send anything, Django makes it easy.

Use this in your settings.py:

<span class="hljs-comment"># Settings.oy</span>
EMAIL_BACKEND = <span class="hljs-string">'django.core.mail.backends.console.EmailBackend'</span>

This prints emails to your console instead of sending them. Perfect for debugging!

Step 2: Sending a Simple Email

Now that your settings are in place, you can send an email with just a few lines of code.

Here’s a quick example using Django’s send_mail function:

<span class="hljs-comment"># Views.py or anywhere you want this logic to live</span>

<span class="hljs-keyword">from</span> django.core.mail <span class="hljs-keyword">import</span> send_mail

send_mail(
    <span class="hljs-string">'Welcome to My Site!'</span>,
    <span class="hljs-string">'Thanks for signing up. Glad to have you!'</span>,
    <span class="hljs-string">'from@example.com'</span>,        <span class="hljs-comment"># From</span>
    [<span class="hljs-string">'to@example.com'</span>],        <span class="hljs-comment"># To</span>
    fail_silently=<span class="hljs-literal">False</span>,
)

And just like that, you’ve sent an email

Step 3: Sending HTML Emails

Plain text is okay, but HTML emails look way better. Django lets you send multi-part messages that include both plain text and HTML.

Here’s how:

<span class="hljs-keyword">from</span> django.core.mail <span class="hljs-keyword">import</span> EmailMultiAlternatives

subject = <span class="hljs-string">'Welcome!'</span>
text_content = <span class="hljs-string">'Thanks for joining us.'</span>
html_content = <span class="hljs-string">'<p>Thanks for <strong>joining</strong> us.</p>'</span>

msg = EmailMultiAlternatives(subject, text_content, <span class="hljs-string">'from@example.com'</span>, [<span class="hljs-string">'to@example.com'</span>])
msg.attach_alternative(html_content, <span class="hljs-string">"text/html"</span>)
msg.send()

Now, your email will look polished in modern email clients but will still work if someone’s email reader only supports plain text.

Step 4: Use Templates for Better Emails

If you’re sending emails with similar structure – like a welcome message or invoice – it makes sense to use templates.

Create a file like welcome_email.html in your templates folder:

<span class="hljs-comment"><!-- templates/welcome_email.html --></span>
<span class="hljs-tag"><<span class="hljs-name">h2</span>></span>Hello {{ user.first_name }}!<span class="hljs-tag"></<span class="hljs-name">h2</span>></span>
<span class="hljs-tag"><<span class="hljs-name">p</span>></span>Welcome to our platform. We’re happy you’re here.<span class="hljs-tag"></<span class="hljs-name">p</span>></span>

Then, load and render it in your email:

<span class="hljs-keyword">from</span> django.template.loader <span class="hljs-keyword">import</span> render_to_string

html_message = render_to_string(<span class="hljs-string">'welcome_email.html'</span>, {<span class="hljs-string">'user'</span>: user})

You can plug this into the EmailMultiAlternatives setup we used above.

Step 5: Common Pitfalls and How to Avoid Them

Here are a few things I’ve seen people run into:

1. Incorrect app passwords: If you’re using Gmail and it keeps failing, double-check your app password setup.

2. Port and TLS confusion: For most SMTP providers:

   • Use port 587 with EMAIL_USE_TLS = True

   • Or port 465 with EMAIL_USE_SSL = True

3. Email going to spam: Use real sender names and avoid spammy subject lines. Consider setting up SPF, DKIM, and DMARC records if you’re going live. Here’s a simple guide on email authentication.

How to Test Emails Without Sending Them

You can use Mailtrap or Papercut SMTP to test emails in a sandboxed environment.

These tools catch emails in a fake inbox, so nothing gets sent to real users. Super useful when you’re working on production-level templates or transactional emails.

FAQs

Can I send attachments with Django emails?

Yes! Use msg.attach() with EmailMessage or EmailMultiAlternatives. Here’s an example:

msg.attach(<span class="hljs-string">'invoice.pdf'</span>, pdf_content, <span class="hljs-string">'application/pdf'</span>)

What’s the difference between send_mail and EmailMessage?

send_mail is a shortcut for simple use cases. For more complex ones – like HTML emails, attachments, or custom headers – EmailMessage or EmailMultiAlternatives is better.

How do I send bulk emails?

Use the send_mass_mail() function or loop through a list and send emails individually. If you’re sending many emails, it’s better to use an email service provider (like SendGrid, Mailgun, and so on) that supports bulk delivery and handles rate limits.

Conclusion

Email is one of those features that seems small until it breaks—or until you need it to shine.

Do you have it working? Great.

Still stuck? Don’t worry – it’s one of those things that gets easier every time.

Further Resources

If you want to dive deeper into emails with Django, check out these links:

• Official Django Email Docs

• Mailtrap Django Guide

• SendGrid Django Integration

• Django Email Templates Package

Source: freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More