django-debug-toolbar
A configurable set of panels that display various debug information about the current request/response.
A floating developer panel that attaches to your Django app during local development and shows database queries, cache hits, template rendering, HTTP headers, and more for every page request.
Django Debug Toolbar is a developer tool that adds a floating panel to Django web applications while you are building them. Django is a Python framework for building websites and web apps. The toolbar appears in the browser during local development and shows detailed information about what is happening behind the scenes for each page request.
The toolbar is organized into separate panels, each covering a different aspect of a request. One panel might show all the database queries a page triggered and how long each one took. Others show information about the HTTP headers, cache usage, template rendering, signals, logging output, and more. Clicking any panel expands it to show the full details. This makes it much easier to spot slow database queries, unexpected redirects, or configuration issues without having to dig through server logs.
The toolbar is intended only for use during development, not on a live production site. It adds overhead and exposes internal details that should not be visible to end users. Installation involves adding it to your Django project's settings file, listing it as an installed app, and including its URL configuration. The README is short and points to a separate documentation site for full setup instructions.
The current release is version 6.3.0 and requires Django 5.2 or newer. It has experimental support for Django's asynchronous views, though the README notes it cannot yet handle concurrent requests reliably and asks users to report any bugs they find.
The project was originally created in 2008 and is now maintained under the django-commons GitHub organization. It is released under the BSD license.
Where it fits
- Identify slow or redundant database queries causing page lag by seeing every SQL statement and its execution time.
- Debug unexpected HTTP redirects or missing cache hits during Django development without digging through server logs.
- Inspect which templates and context variables rendered a specific page to track down display bugs.