---
id: django-jsonfield
version: "1.4.1"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# django-jsonfield — JSONField for django models

License: permissive · Maintenance: abandoned · Downloads: 125.4K/mo

## What it is and what it does

django-jsonfield is a Django model field that stores JSON-encodable Python objects (dicts, lists, strings) as text in the database and automatically deserializes them back to Python on retrieval. It was created in 2010 to fill a gap when databases lacked native JSON support, but that landscape has changed significantly.

The package is now in maintenance-only mode and explicitly abandoned. Django 3.1 (released August 2020) introduced a native cross-database JSONField that supersedes this library. The maintainer recommends using either Django 3.1's built-in field, the django-jsonfield-backport package for older Django versions, or simply storing JSON in a TextField if you don't need database-level querying of JSON contents.

Use it for:

- Storing flexible, schema-less JSON data in Django models on older Django versions (pre-3.1) that lack native JSONField support.
- Migrating legacy projects that already use this field and cannot yet upgrade to Django 3.1+.
- Adding a jsonify template tag to convert Python data structures to JSON within Django templates with XSS protection.

## Worth the install?

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

Provides a JSONField for Django models that stores JSON-encodable objects in the database and deserializes them on retrieval.

No. The package is abandoned (last commit June 2021, repository archived) and the maintainer explicitly recommends against using it on new projects. Use Django 3.1's native JSONField instead, or django-jsonfield-backport for older Django versions. Only install if maintaining legacy code already using this field.

## Install

pip install django-jsonfield
uv add django-jsonfield
poetry add django-jsonfield

## Installing django-jsonfield

Before you install: Low install friction with only Django and six as runtime dependencies. However, the package is abandoned as of June 2021 and explicitly not recommended for new projects—Django 3.1+ includes a native cross-database JSONField that should be used instead.

License in practice: Licensed under BSD (permissive), so no legal restrictions on use, but the abandoned status and explicit recommendation against new projects should weigh more heavily than the license.

Quickstart:

pip install django-jsonfield

from django.db import models
import jsonfield

class MyModel(models.Model):
    the_json = jsonfield.JSONField()

Requires Django 1.8 or later; not compatible with Django 3.1+ without conflicts (see issue #5 regarding django.contrib.postgres.fields.JSONField interference).

Verify before relying:

- Whether the package works reliably with modern Django versions beyond 2.2 (last tested version mentioned in history).
- Current state of compatibility with Python 3.8+ given the package's age and abandoned status.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 125.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django json field, store json in django models, django jsonfield, json serialization django, django model json column, legacy, django-orm

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