Repolode
Submit
django-commons

django-commons/django-debug-toolbar

A configurable set of Django panels that show debug information about each request and response in the browser.

View on GitHubWebsite
Stars
8,379
Forks
1,122
Open issues
71
Last commit
3 days ago

What is it?

Django Debug Toolbar is a development tool for Django projects. It adds a toolbar to rendered pages, and each panel on it shows one kind of debug information about the current request and response, such as SQL queries, headers, templates, and timing. Clicking a panel opens more detail about its contents.

The toolbar is built from a configurable set of panels, and the community has contributed many third-party panels as well. It currently requires Django 5.2 or later. It has experimental support for Django's async views, but it does not yet handle concurrent requests.

Installation and configuration are covered in the project's online documentation. The package is released under the BSD-3-Clause license.

Key features

  • 01Shows SQL queries executed during a request.
  • 02Displays request and response headers, templates, and timing information.
  • 03Supports built-in panels plus community-contributed third-party panels.
  • 04Adds experimental support for Django async views.

Use cases

  • Finding N+1 query problems while developing a Django view.
  • Inspecting template rendering and context during local development.
  • Checking request and response headers when debugging an API endpoint.

Quick start

  1. 1

    Follow the installation and configuration instructions in the documentation

Things to know

  • Support for Django's async views is experimental and the toolbar cannot yet handle concurrent requests.
  • It requires Django 5.2.0 or newer.

In collections

Databases & SQL tools

Topics

#django#debugging#python#web-development#profiling#sql

FAQ

What is django-debug-toolbar?
A configurable set of Django panels that show debug information about each request and response in the browser. Django Debug Toolbar is a development tool for Django projects. It adds a toolbar to rendered pages, and each panel on it shows one kind of debug information about the current request and response, such as SQL queries, headers, templates, and timing. Clicking a panel opens more detail about its contents.
Is django-debug-toolbar free to use? What license does it have?
django-debug-toolbar is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
Is django-debug-toolbar still maintained?
Actively maintained. The last commit to django-debug-toolbar was on Nov 3, 2026.
What can I use django-debug-toolbar for?
Finding N+1 query problems while developing a Django view. Inspecting template rendering and context during local development. Checking request and response headers when debugging an API endpoint.
How do I install django-debug-toolbar?
Follow the installation and configuration instructions in the documentation
Where can I get django-debug-toolbar?
The source code and installation instructions are on GitHub: https://github.com/django-commons/django-debug-toolbar

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects