How to use the Messages Framework | Django Tutorial

How to use the Messages Framework | Django Tutorial

/ #Django


Django comes with a fantastic feature called Messages. This makes it easy to show messages to your users.

Why should I use Messages?

Messages are used so you can give feedback to your visitors when something happens. Like if they submit a form, you might want to show a success message if everything is okay. Or you might want to show a message if there was an error.

Messages are built into all new Django projects, so you don't have to think about that.

A little example

Let's make a simple Django view where the user has submitted a contact form.

from django.contrib import messages
from django.shortcuts import render

def contact(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)

        if form.is_valid():
            form.save()

            messages.success(request, 'The contact form was submitted!')
    else:
        form = ContactForm()

    return render(request, 'contact.html', {'form': form})

First we need to import Messages like we do on line 1. On line 11, we create a new Message.

Notice that we don't add the messages to the context for the frontend. This is because the messages is added to the session.

To show the messages, you can do the following:

{% if messages %}
    <ul class="messages">
        {% for message in messages %}
            <li class="{{ message.tags }}">{{ message }}</li>
        {% endfor %}
    </ul>
{% endif %}

This will generate something like this:

<ul class="messages">
  <li class="success">The contact form was submitted!</li>
</ul>

Different types of messages

Constant Level Tag (CSS class) Purpose
DEBUG 10 debug Messages for helping you debug your application.
INFO 20 info Simple informational messages.
SUCCESS 25 success Messages for successful actions.
WARNING 30 warning Messages for warning the user. Like "Almost full disk".
ERROR 40 error Messages for showing errors.

DEBUG can only be used during development. In production, Django will automatically hide these messages.

Using together with Bulma / Custom classes

If you use a CSS framework like Bulma or Bootstrap, you often want to customize the message class. This can be done by adding an extra parameter like this.

from django.contrib import messages
from django.shortcuts import render

def contact(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)

        if form.is_valid():
            form.save()

            messages.success(request, 'The contact form was submitted!', extra_tags='is-success')
    else:
        form = ContactForm()

    return render(request, 'contact.html', {'form': form})

To show the messages, you can do the following:

{% if messages %}
    {% for message in messages %}
        <div class="notification {{ message.tags }}">{{ message }}</div>
    {% endfor %}
{% endif %}

This will generate something like this:

<div class="notification success is-success">The contact form was submitted!</div>

Comments

guilherme | Jun 14, 21 02:56

The {% if messages %} goes in template?

Stein Ove Helset | Jun 17, 21 04:26

guilherme, yes, that is correct :-)

Cellou Cisse | Oct 18, 21 07:24

Thank you for this post. It's very helpful

Add comment

Info

Please log in to comment!

Newsletter

Subscribe to my weekly newsletter. One time per week I will send you a short summary of the tutorials I have posted in the past week.