---
id: django-graphiql-debug-toolbar
version: "0.2.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# django-graphiql-debug-toolbar — Django Debug Toolbar for GraphiQL IDE.

License: permissive · Maintenance: dormant · Downloads: 177.4K/mo

## What it is and what it does

This package adapts Django Debug Toolbar—a widely-used development tool that profiles database queries, HTTP headers, and request timing—to work inside the GraphiQL IDE for GraphQL queries. Instead of viewing debug output in a separate browser panel, you get profiling and inspection data directly within your GraphQL development environment.

It works by replacing the standard Django Debug Toolbar middleware with a GraphiQL-aware version that captures the same diagnostic information but surfaces it in the IDE. The package depends on Django, graphene-django, and django-debug-toolbar, so you need all three installed. Setup is minimal: add it to INSTALLED_APPS and swap the middleware class in your settings.

Use it for:

- Inspect database queries triggered by a GraphQL resolver without leaving the GraphiQL IDE.
- Profile response times and identify performance bottlenecks in GraphQL queries during development.
- Debug HTTP headers and middleware behavior for GraphQL requests in real time.
- Monitor memory usage and request metadata while testing GraphQL resolvers locally.

## Worth the install?

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

Integrates Django Debug Toolbar into the GraphiQL IDE, providing performance profiling and debugging information directly within GraphQL query execution.

Yes, if you are actively developing a Django GraphQL API and want integrated debugging without context-switching. No, if your project uses Django or Python versions significantly newer than 2021, or if you rely on ongoing maintenance—the package is dormant and may not work with current tooling. Consider it for greenfield projects or teams committed to older Django LTS versions.

## Install

pip install django-graphiql-debug-toolbar
uv add django-graphiql-debug-toolbar
poetry add django-graphiql-debug-toolbar

## Installing django-graphiql-debug-toolbar

Before you install: Low friction install with three straightforward dependencies. Maintenance is dormant—last release was in August 2021 and no commits since July 2024—so expect no active bug fixes or compatibility updates for newer Django or Python versions.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

pip install django-graphiql-debug-toolbar

# In settings.py
INSTALLED_APPS = [
    'debug_toolbar',
    'graphiql_debug_toolbar',
]

MIDDLEWARE = [
    'graphiql_debug_toolbar.middleware.DebugToolbarMiddleware',
]

# Then use GraphiQL as normal; debug toolbar appears in the IDE

Requires Django ≥ 2.2 and Python ≥ 3.6; you must also have graphene-django and django-debug-toolbar installed and configured.

Verify before relying:

- Whether this package works reliably with Django versions released after August 2021 (3.2 is the latest classifier listed).
- Current compatibility with modern Python 3.10+ and recent graphene-django releases.
- Whether the GraphiQL IDE integration still functions with current GraphQL tooling.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 177.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

graphql debugging toolbar, django graphiql profiler, graphql query performance analysis, django debug toolbar graphql, graphiql development tools, graphql request inspection, django graphql debugging, graphql-debugging, django-dev-tools

[View on SkillFed](https://skillfed.io/packages/django-graphiql-debug-toolbar) · [View on PyPI](https://pypi.org/project/django-graphiql-debug-toolbar/)