django messages framework example

Nov. 11, 2020, 9:56 a.m.

Django messages framework provides a way of notifying users that a certain action was done. For example when you are changing your password, you might get this message "your password was changed successfully" . The message is important because it assures the user that indeed a certain action was done successfully. Django documentation says that

The messages framework allows you to temporarily store messages in one request and retrieve them for display in a subsequent request (usually the next one). Every message is tagged with a specific level that determines its priority (e.g., info, warning, or error).

How do we enable messages ?

Django messages framework is enabled by default, so you do not need to change anything in file.

Message levels

The message levels help us in grouping messages by type, we have the following message levels.

Constant         Purpose

DEBUG           Development-related messages that will be ignored

                    (or removed) in a production deployment.

INFO             Informational messages for the user .

SUCCESS       An action was successful, e.g. “Your profile was updated successfully” .

WARNING      A failure did not occur but may be imminent.

ERROR          An action was not successful or some other failure occurred.

Message tags

Message tags are string representation of the message levels, they are used as CSS classes and they will help in styling different messages. For example you might want warning messages to appear as red in color and success message to appear as green, message tags will help you in achieving that.

Level Constant         Tag

DEBUG                         debug

INFO                           info

SUCCESS                     success

WARNING                     warning

ERROR                         error

Using messages in views

In this example we will add a success message when the image is uploaded successfully. checkout the full source code of this example app here

def model_form_upload(request):
    if request.method == 'POST':
        form = DocumentForm(request.POST, request.FILES)
        if form.is_valid():
            messages.success(request, 'your image was uploaded successfully') # added success message here
            return redirect('home')
        form = DocumentForm()
    return render(request, 'uploads/model_form_upload.html', {
        'form': form

and then in the template you can display the message like this

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

This was a very simple example of how Django's messages framework works. For more information on this topic checkout Vitor Freitas tutorial on the same topic, he covers a lot , from adding bootstrap to custom message tags.


Keep Learning