Messages framework for flash messages in Django

Introduction

The messages framework helps show short notifications to users after actions, like "Profile saved" or "Error occurred". It makes user feedback easy and clear.

After a user submits a form to confirm success or show errors.

To notify users about login or logout status.

To display warnings or info messages on page reload.

When redirecting users and you want to show a quick message.

To give feedback after actions like deleting or updating data.

Syntax

Django

from django.contrib import messages

messages.debug(request, 'Debug message')
messages.info(request, 'Info message')
messages.success(request, 'Success message')
messages.warning(request, 'Warning message')
messages.error(request, 'Error message')

Use the messages module imported from django.contrib.

Each message type has a function: debug, info, success, warning, and error.

Examples

Shows a green success message after updating a profile.

Django

messages.success(request, 'Your profile was updated successfully!')

Shows a red error message if saving fails.

Django

messages.error(request, 'There was a problem saving your data.')

Shows a blue info message to remind the user.

Django

messages.info(request, 'Remember to verify your email address.')

Sample Program

This view adds a success message after form submission and redirects to home. The template shows all messages in a list.

Django

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

def submit_form(request):
    if request.method == 'POST':
        # pretend form is valid
        messages.success(request, 'Form submitted successfully!')
        return redirect('home')
    return render(request, 'form.html')

# In the template (form.html), you would loop over messages:
# {% if messages %}
#   <ul>
#   {% for message in messages %}
#     <li>{{ message }}</li>
#   {% endfor %}
#   </ul>
# {% endif %}

Important Notes

Messages are stored temporarily and disappear after being displayed once.

Make sure your template loops over messages to show them.

The framework works well with redirects to show messages on the next page.

Summary

The messages framework shows quick feedback messages to users.

Use different message levels for success, error, info, etc.

Messages appear once and require template code to display.