---
id: django-json-widget
version: "2.1.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# django-json-widget — Django json widget is an alternative widget that makes it easy to edit the jsonfield field of django.

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

## What it is and what it does

django-json-widget is a Django admin and form widget that replaces the default text input for JSONField with a visual JSON editor. It provides syntax highlighting, validation, and a structured editing interface for JSON data, making it easier for users to edit complex JSON structures without manually writing or parsing raw JSON text.

The widget integrates directly into Django's admin interface and forms through standard Django widget overrides. It exposes the underlying editor instance to JavaScript for programmatic access, allowing custom code to manipulate JSON data. Configuration options control editor dimensions and behavior through a dict of options. The package maintains active development with recent fixes for dark mode support and Django version compatibility.

Use it for:

- Editing configuration data stored as JSON in Django admin without writing raw JSON syntax
- Building forms that accept complex nested JSON structures with visual validation feedback
- Providing non-technical users a safer interface to modify JSON fields in production data
- Integrating custom JavaScript logic to programmatically update JSON editor content from other form fields
- Supporting dark mode Django admin themes with automatic color scheme adaptation

## Worth the install?

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

Provides a rich JSON editor widget for Django's admin interface and forms, enabling visual editing of JSONField data with syntax highlighting and validation.

Yes. Low install friction, no runtime dependencies, active maintenance, permissive MIT license, and no known vulnerabilities make this a straightforward choice for Django projects using JSONField. Install if you need a better admin/form interface for JSON editing; skip only if you have no JSONField usage or prefer raw JSON input.

## Install

pip install django-json-widget
uv add django-json-widget
poetry add django-json-widget

## Installing django-json-widget

Before you install: Low friction installation with no runtime dependencies. Active maintenance with recent releases; last commit 2026-05-08 and latest release 2025-12-12 indicate ongoing support.

License in practice: MIT license (permissive) allows use in both open-source and proprietary projects with minimal restrictions.

Quickstart:

pip install django-json-widget

# In settings.py
INSTALLED_APPS = [
    ...,
    'django_json_widget',
]

# In admin.py
from django.contrib import admin
from django.db.models import JSONField
from django_json_widget.widgets import JSONEditorWidget

@admin.register(YourModel)
class YourModelAdmin(admin.ModelAdmin):
    formfield_overrides = {
        JSONField: {'widget': JSONEditorWidget},
    }

Verify before relying:

- Whether the widget works with non-PostgreSQL database JSONField implementations (description mentions PostgreSQL-specific fields)
- Performance characteristics with large JSON documents
- Browser compatibility requirements for the embedded JSON editor

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 1.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django json field editor, django admin json widget, json editor for django forms, django jsonfield ui, visual json editing django, django json admin interface, json syntax highlighting django, django-admin, json-editing, form-widget

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