# django-debug-toolbar

> A configurable set of panels that display various debug information about the current request/response.

- **URL**: https://www.freshcrate.ai/projects/django-debug-toolbar
- **Author**: Rob Hudson
- **Category**: Frameworks
- **Latest version**: `6.3.0` (2026-04-21)
- **License**: BSD-3-Clause
- **Source**: https://github.com/django-commons/django-debug-toolbar
- **Homepage**: https://pypi.org/project/django-debug-toolbar/
- **Language**: Python
- **GitHub**: 8,354 stars, 1,082 forks
- **Registry**: pypi (`django-debug-toolbar`)
- **Tags**: `pypi`

## Description

=====================================
Django Debug Toolbar |latest-version|
=====================================

|build-status| |coverage| |docs| |python-support| |django-support|

.. |latest-version| image:: https://img.shields.io/pypi/v/django-debug-toolbar.svg
   :target: https://pypi.org/project/django-debug-toolbar/
   :alt: Latest version on PyPI

.. |build-status| image:: https://github.com/django-commons/django-debug-toolbar/workflows/Test/badge.svg
   :target: https://github.com/django-commons/django-debug-toolbar/actions/workflows/test.yml
   :alt: Build Status

.. |coverage| image:: https://img.shields.io/badge/Coverage-94%25-green
   :target: https://github.com/django-commons/django-debug-toolbar/actions/workflows/test.yml?query=branch%3Amain
   :alt: Test coverage status

.. |docs| image:: https://img.shields.io/readthedocs/django-debug-toolbar/latest.svg
   :target: https://readthedocs.org/projects/django-debug-toolbar/
   :alt: Documentation status

.. |python-support| image:: https://img.shields.io/pypi/pyversions/django-debug-toolbar
   :target: https://pypi.org/project/django-debug-toolbar/
   :alt: Supported Python versions

.. |django-support| image:: https://img.shields.io/pypi/djversions/django-debug-toolbar
   :target: https://pypi.org/project/django-debug-toolbar/
   :alt: Supported Django versions

The Django Debug Toolbar is a configurable set of panels that display various
debug information about the current request/response and when clicked, display
more details about the panel's content.

Here's a screenshot of the toolbar in action:

.. image:: https://raw.github.com/django-commons/django-debug-toolbar/main/example/django-debug-toolbar.png
   :alt: Django Debug Toolbar screenshot

In addition to the built-in panels, a number of third-party panels are
contributed by the community.

The current stable version of the Debug Toolbar is 6.3.0. It works on
Django ≥ 4.2.0.

The Debug Toolbar has experimental support for `Django's asynchronous views
<https://docs.djangoproject.com/en/dev/topics/async/>`_. Please note that
the Debug Toolbar still lacks the capability for handling concurrent requests.
If you find any issues, please report them on the `issue tracker`_.

Documentation, including installation and configuration instructions, is
available at https://django-debug-toolbar.readthedocs.io/.

The Django Debug Toolbar is released under the BSD license, like Django
itself. If you like it, please consider contributing!

The Django Debug Toolbar was originally created by Rob Hudson <rob@cogit8.org>
in August 2008 and was further developed by many contributors_.

.. _contributors: https://github.com/django-commons/django-debug-toolbar/graphs/contributors
.. _issue tracker: https://github.com/django-commons/django-debug-toolbar/issues

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `6.3.0` | 2026-04-21 | Low | Imported from PyPI (6.3.0) |
| `6.2.0` | 2026-01-20 | Low | <!-- Release notes generated using configuration in .github/release.yml at 6.2.0 -->  ## What's Changed * Deprecate RedirectsPanel in favor of the HistoryPanel by @JohananOppongAmoateng in https://github.com/django-commons/django-debug-toolbar/pull/2223 * Add cache view to example app by @federicobond in https://github.com/django-commons/django-debug-toolbar/pull/2243 * Add zizmor for GHA security analysis by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2201 |
| `6.1.0` | 2025-10-30 | Low | ## What's Changed  See [change log here](https://django-debug-toolbar.readthedocs.io/en/latest/changes.html#:~:text=6.1.0%20(2025-10-30))  Commits: * Added a note about the default password in make example by @abdibaker in https://github.com/django-commons/django-debug-toolbar/pull/2180 * Removed logging about the toolbar failing to serialize a value into JSON by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2181 * Explicitly call out the selenium job in th |
| `6.0.0` | 2025-07-25 | Low | ## Description  The v6.0.0 release of Django Debug Toolbar significantly revamps how panels for the toolbar work. Each panel will now persist its data in a store. A store can either be backed by various backends. The toolbar will support a memory and database backend to start.  **The toolbar is now using Django's `SafeExceptionReporterFilter.cleanse_setting()` function to filter out sensitive information.** Some data will be replaced with `"********************"`. This is because the toolbar |
| `5.2.0` | 2025-04-29 | Low | ## What's Changed * Enhance RedirectsPanel with customizable redirect response hook by @blingblin-g in https://github.com/django-commons/django-debug-toolbar/pull/2104 * Sanitize sensitive variables in RequestPanel by @dr-rompecabezas in https://github.com/django-commons/django-debug-toolbar/pull/2105 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2112 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https: |
| `5.1.0` | 2025-03-20 | Low | ## What's Changed * Update version for sigstore action to full version. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2056 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2053 * Add Django 5.2 to tox matrix by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2064 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/ |
| `5.0.1` | 2025-01-14 | Low | ## What's Changed  There were no functional changes in this version.  ### PRs  * Update release workflows to latest trusted publisher GHA. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2054   **Full Changelog**: https://github.com/django-commons/django-debug-toolbar/compare/5.0.0...5.0.1 |
| `5.0.0` | 2025-01-11 | Low | ## What's Changed  Please note that Django Debug Toolbar has now moved into the Django Commons organization.  ### Changelog  * Added Python 3.13 to the CI matrix. * Removed support for Python 3.8 as it has reached end of life. * Converted to Django Commons PyPI release process. * Fixed a crash which occurred when using non-``str`` static file values. * Documented experimental async support. * Improved troubleshooting doc for incorrect mime types for .js static files * Support async a |
| `5.0.0-alpha` | 2024-09-02 | Low | ## Why 5.0 and why alpha?  Version 5.0 does not contain any backwards incompatible changes. Instead it should be more compatible with async Django projects. However, the change did require some reasonably sized changes to the middleware. This is a large enough change that we wanted it to be effectively communicated to users of the toolbar.  This release is an alpha because the async logic was tested, but we also understand that we haven't tested it in every scenario. We fully expect the proj |
| `4.4.6` | 2024-07-10 | Low | ## What's Changed * Close #1509: Revert the infinite recursion fix, Django has changed the behavior by @matthiask in https://github.com/jazzband/django-debug-toolbar/pull/1955 * Fixed order and grammatical number of panels in documentation by @bkdekoning in https://github.com/jazzband/django-debug-toolbar/pull/1956 * Alerts panel: Only process HTML responses by @matthiask in https://github.com/jazzband/django-debug-toolbar/pull/1960   **Full Changelog**: https://github.com/jazzband/django- |

## Citation

- HTML: https://www.freshcrate.ai/projects/django-debug-toolbar
- Markdown: https://www.freshcrate.ai/projects/django-debug-toolbar.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/django-debug-toolbar/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._
