Tracking dirty fields on a Django model
Latest commit 4e2d9d1 Feb 8, 2017 @romgar committed on GitHub Merge pull request #100 from romgar/update_travis_for_py35
Update travis/tox to use python 3.5


Django Dirty Fields

Join the chat at

Tracking dirty fields on a Django model instance. Dirty means that field in-memory and database values are different.

This package is compatible and tested with all officially supported versions of Django (1.8, 1.9, 1.10 series).

Full documentation


$ pip install django-dirtyfields


To use django-dirtyfields, you need to:

  • Inherit from DirtyFieldMixin in the Django model you want to track.
from django.db import models
from dirtyfields import DirtyFieldsMixin

class TestModel(DirtyFieldsMixin, models.Model):
    """A simple test model to test dirty fields mixin with"""
    boolean = models.BooleanField(default=True)
    characters = models.CharField(blank=True, max_length=80)
  • Use one of these 2 functions on a model instance to know if this instance is dirty, and get the dirty fields:

    • is_dirty()
    • get_dirty_fields()


>>> from tests.models import TestModel
>>> tm = TestModel.objects.create(boolean=True,characters="testing")
>>> tm.is_dirty()
>>> tm.get_dirty_fields()

>>> tm.boolean = False

>>> tm.is_dirty()
>>> tm.get_dirty_fields()
{'boolean': True}

Consult the full documentation for more informations.