Django JSONEditor input widget to provide javascript online JSON Editor





GitHub Stars



Last Commit

15d ago










Django-JSONEditor is an online structured JSON input widget for Django appropriate for various JSONField's provided for Django.

Code of the javascript JSONEditor online editor has been got from the

See the latest versions of the javascript online JSON Editor here:

Sample views:

json editor

Don't mismatch this repo with


Latest version from the GIT repository::

pip install "git+git://"

Stable version from the PyPi repository::

pip install django-jsoneditor

Note that you should use one of original JSONField packages to provide the JSONField itself.


You should append jsoneditor into the INSTALLED_APPS of your file:


You can use CDN repositories to get JSONEditor javascript code, or host it yourself, instead of the packaged one using the following two settings in your file:

JSON_EDITOR_JS = 'whatever-your-want.js'
JSON_EDITOR_CSS = 'whatever-your-want.css'

Just look to the and select the preferred one, like:


Custom JSONEditor initialization

You can change initial parameters for the jsoneditor.JSONEditor javascript constructor initial call for your own purposes using JSON_EDITOR_INIT_JS settings. Copy the jsoneditor/static/django-jsoneditor/init.js file to your own static storage, change initial values of the django_jsoneditor_init object and setup the JSON_EDITOR_INIT_JS variable of the settings file to point your own modified copy of the file.

Note that the django original static file subsystem is used to refer to the init file.

For example, let's your project has a myapp application, and you would like to init all available modes of the JSONEditor instead of two allowed by default.

  • copy the jsoneditor/static/django-jsoneditor/init.js to myapp/static/jsoneditor-init.js file
  • change content of the myapp/static/jsoneditor-init.js to:
django_jsoneditor_init = {
    mode: 'tree',
    modes: ['code', 'form', 'text', 'tree', 'view'] // all modes
  • insert into your file the following code:
JSON_EDITOR_INIT_JS = "jsoneditor-init.js"

(note that the static file subsystem refers to static files without static prefix)

Also you can extend the JSON_EDITOR_INIT_JS file as you wish, it will be used on every page where the JSONEditor widget is used just before the django-jsonfield.js file.

Custom Ace initialization

In the same fashion, you can also set options for the Ace editor that is initialized when either starting with or switching to 'code' mode. These options can be found here: This can for example come in handy when wanting to customize for example the height or looks of the editor. The default of this file can be found in jsoneditor/static/django-jsoneditor/ace_options.js, which is empty. A custom one can be pointed to by adding the following line to your

JSON_EDITOR_ACE_OPTIONS_JS = "[your_ace_options_file].js"


You can use the JSONEditor widget for fields in selected Admin classes like:

from json_field import JSONField
from jsoneditor.forms import JSONEditor
class MyAdmin(admin.ModelAdmin):
    formfield_overrides = {
        JSONField:{ 'widget':JSONEditor },

Or use the original JSONField implementation fixed by the package.

Right now there are the following fixed implementations:

To use the fixed implementation instead of the original one, just replace your import with the desired one. For example, for Django 3.0 and above:

from django.db import models

# from json_field import JSONField replaced by:
from jsoneditor.fields.django3_jsonfield import JSONField
# Create your models here.

class TestModel(models.Model):
    my_field = JSONField()

You can access the underlying JSONEditor JS objects in your JavaScript via dictionary named jsonEditors. This dictionary's keys are the IDs of the fields generated by this component in the form: "id"+[your form field name]+"_json_jsoneditor", e.g. id_template_parameters_json_jsoneditor. The values in the dictionary are the instances of the correspondent JSONEditor objects.

Collecting bounties

You are free to give some bounties on to force solving existent or new issues

Rate & Review

Great Documentation0
Easy to Use0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Unwelcoming Community0