Skip to content
This repository

Reusable JSONField() for Django

branch: master

Merge pull request #63 from adam-iris/master

Set load_kwargs on JSONFormFieldBase instance
latest commit 59a8a8875b
Brad Jasper authored
Octocat-spinner-32 jsonfield Set load_kwargs on JSONFormFieldBase instance November 22, 2013
Octocat-spinner-32 .gitignore Added .idea to .gitignore. November 11, 2012
Octocat-spinner-32 .travis.yml bump to 0.9.20 November 14, 2013
Octocat-spinner-32 LICENSE added License July 10, 2012
Octocat-spinner-32 Added README + bump March 26, 2013
Octocat-spinner-32 README.rst Update README.rst February 10, 2014
Octocat-spinner-32 bump to 0.9.20 November 14, 2013


django-jsonfield is a reusable Django field that allows you to store validated JSON in your model.

It silently takes care of serialization. To use, simply add the field to one of your models.

New: Python 3 support added!


pip install jsonfield


from django.db import models
from jsonfield import JSONField

class MyModel(models.Model):
  json = JSONField()

Advanced Usage

By default python deserializes json into dict objects. This behavior differs from the standard json behavior because python dicts do not have ordered keys.

To overcome this limitation and keep the sort order of OrderedDict keys the deserialisation can be adjusted on model initialisation:

import collections
class MyModel(models.Model):
  json = JSONField(load_kwargs={'object_pairs_hook': collections.OrderedDict})

Other Fields


If you need to use your JSON field in an index or other constraint, you can use JSONCharField which subclasses CharField instead of TextField. You'll also need to specify a max_length parameter if you use this field.


django-jsonfield supports Python 2.7-Python 3.3 and Django 1.4+

Why doesn't it support Python 2.6?

You actually might be OK if you don't use an OrderedDict, but there are some issues with the simplejson API that make it cumbersome to support.

Why doesn't it support Django 1.3?

There was a bug that could only be fixed by a feature in Django 1.4. Read More if you're interested in the details.

Travis CI



Twitter: @bradjasper



v0.9.20, 11/14/2013 -- Fixed load_kwargs on form fields, added Django 1.6 to automated tests

v0.9.19, 09/18/2013 -- Fixed changes to django.six.with_metaclass that broke django-jsonfield for Django 1.6

v0.9.18, 08/23/2013 -- Fixed bugs with South datamigration

v0.9.17, 06/07/2013 -- Fixed bugs in JSONCharField admin form

v0.9.14/15/16, 04/29/2013 -- Python 3 support added!

v0.9.11/12/13, 03/26/2013 -- PyPi changes

v0.9.9/10/11, 03/21/2013 -- PyPi changes

v0.9.8, 03/21/2013 -- Added support for native PostgreSQL JSON data type

v0.9.7, 03/21/2013 -- Fix bug #33 where JSONField didn't correctly store some values inside of strings

Something went wrong with that request. Please try again.