Refs -- Added example to JSONField release notes.
@@ -70,8 +70,25 @@ JSONField for all supported database backends
Django now includes :class:`.models.JSONField` and
:class:`forms.JSONField <django.forms.JSONField>` that can be used on all
supported database backends. Both fields support the use of custom JSON
-encoders and decoders. The model field supports the introspection, lookups, and
-transforms that were previously PostgreSQL-only.
+encoders and decoders. The model field supports the introspection,
+:ref:`lookups, and transforms <querying-jsonfield>` that were previously
+PostgreSQL-only::
+
+ from django.db import models
+
+ class ContactInfo(models.Model):
+ data = models.JSONField()
+
+ ContactInfo.objects.create(data={
+ 'name': 'John',
+ 'cities': ['London', 'Cambridge'],
+ 'pets': {'dogs': ['Rufus', 'Meg']},
+ })
+ ContactInfo.objects.filter(
+ data__name='John',
+ data__pets__has_key='dogs',
+ data__cities__contains='London',
+ ).delete()
If your project uses ``django.contrib.postgres.fields.JSONField``, plus the
related form field and transforms, you should adjust to use the new fields,
