---
id: flask-debugtoolbar
version: "0.16.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# Flask-DebugToolbar — A toolbar overlay for debugging Flask applications.

License: permissive · Maintenance: active · Downloads: 1.3M/mo

## What it is and what it does

Flask-DebugToolbar is a Flask extension that automatically injects a sidebar overlay into HTML pages during development, showing debugging information about the current request and application state. It is designed as a port of Django's debug toolbar and integrates seamlessly with Flask's debug mode, requiring only a few lines of setup code to enable.

The toolbar displays configurable panels of diagnostic data and is injected directly into Jinja templates when debug mode is active. It helps developers inspect requests, view template context, and understand application behavior during development without requiring external tools or manual instrumentation.

Use it for:

- Inspect HTTP request and response details, headers, and cookies during development.
- Debug Jinja template rendering and view the context variables passed to templates.
- Monitor database queries and other instrumented operations in real time.
- Profile application performance and identify bottlenecks during development.
- Understand Flask configuration and extension state without adding print statements.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Flask-DebugToolbar injects a debugging sidebar into rendered HTML pages when Flask debug mode is enabled, displaying configurable panels of information about requests, templates, and application state.

Yes. Flask-DebugToolbar is a low-friction, actively maintained development tool with no security vulnerabilities, a permissive license, and a single dependency. It is worth installing for any Flask project in active development where visibility into request handling and template rendering would aid debugging.

## Install

pip install flask-debugtoolbar
uv add flask-debugtoolbar
poetry add flask-debugtoolbar

## Installing Flask-DebugToolbar

Before you install: Low install friction with a single runtime dependency on flask. The project is actively maintained as part of the Pallets Community Ecosystem, with recent commits and a stable release cadence.

License in practice: Licensed under a permissive BSD license, allowing use in both open-source and proprietary projects without significant restrictions.

Quickstart:

from flask import Flask
from flask_debugtoolbar import DebugToolbarExtension

app = Flask(__name__)
app.config["SECRET_KEY"] = "your-secret-key"
toolbar = DebugToolbarExtension(app)

Flask debug mode must be enabled for the toolbar to inject into templates; typically run with `flask run --debug`.

Verify before relying:

- What specific debugging information panels are available (e.g., SQL queries, cache, headers, profiling).
- Whether the toolbar works with all Flask template engines or only Jinja2.
- Performance impact when the toolbar is active on production-like workloads.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

flask debug toolbar, flask debugging extension, flask request inspection, flask development debugging, flask html debug panel, flask application profiling, flask template debugging, flask-extension, development-tool, debugging

[View on SkillFed](https://skillfed.io/packages/flask-debugtoolbar) · [View on PyPI](https://pypi.org/project/flask-debugtoolbar/)