Requirements

• Django 4.2: See older versions for earlier version of Django.

• Add the middleware to also store the current user:

  MIDDLEWARE = (
      ...
      "tracking_fields.middleware.cuser.CuserMiddleware",
      ...
  )

Quick start

1. Add “tracking_fields” to your INSTALLED_APPS settings.

2. Add the tracking_fields.decorators.track decorator to your models with the fields you want to track as parameters:

   @track('test', 'm2m')
   class MyModel(models.Model):
       test = models.BooleanField('Test', default=True)
       m2m = models.ManyToManyField(SubModelTest, null=True)

3. Your objects are now tracked. See the admin site for the tracking information.

4. If you want to track who does the changes, please install the django-cuser app.

5. You can also track fields of related objects:

   class MyModel(models.Model):
       test = models.BooleanField('Test', default=True)
   
   @track('related__test')
   class MyOtherModel(models.Model):
       related = models.ForeignKey(MyModel)

6. You can run the tests with tox (make sure to have django-cuser installed).

./manage.py migrate --fake tracking_fields zero
./manage.py migrate tracking_fields

1.5.2 (2026-03-16)

• Fix datetime.time serialization

1.5.1 (2026-03-06)

• Add missing middleware file to release

1.5.0 (2026-03-05)

• Drop Django support < 4.2

• Add Django 6.0 support

• Fix UUID serialization

• Include cuse middleware inside tracking fields as it is no longer maintained

1.4.0 (2023-06-15)

• Drop Django < 3.2 support

• Add Django 4.2 support

• Do not store M2M managers on the instance as original values.

• Fix TrackerEventUserFilter performance.

1.3.7 (2022-04-07)

• Do not tracked deferred related fields.

1.3.6 (2022-03-16)

• Fix error on admin related to filtering content from deleted user

• Fix deprecation warnings for Django 5.0.

• Django 3.2 and 4.0 compatibility

1.3.5 (2022-03-09)

• Increase max_length of TrackedFieldModification.field from 40 to 250

1.3.4 (2021-11-24)

• Bulk create TrackedFieldModification

1.3.3 (2021-10-25)

• Fix tracking of models with uuid ids

1.3.2 (2021-09-01)

• Fix related event when there is no backward relation.

1.3.1 (2021-02-19)

• Added get_object_model_verbose_name.

1.3.0 (2021-02-19)

• Added get_object_model on TrackingEvent to be able to get model class in templates.

• Fix deprecation warnings for Django 4.0.

• Drop support for Django 2.0 and 2.1.

1.2.1 (2020-10-20)

• Deferred fields are not tracked to avoid additional requests.

1.2.0 (2020-05-07)

• fix ‘str’ object has no attribute ‘name’ #6

• Django 3.0 compatibility

• Drop support for Django 1.11

1.1.2 (2019-09-11)

• added serialization for xworkflow StateWrapper

1.1.1 (2019-01-25)

• Optimize admin user lookup

1.1.0 (2019-01-24)

• Compatibility with Django 1.11 to 2.1

• Compatibility droped for earlier versions

1.0.6

• Fix unicode error in admin with Python 3.4 and django_cuser

1.0.5

• Fix MANIFEST

1.0.4

• Order TrackingEvent by -date

1.0.3

• Fix MANIFEST

1.0.2

• Include migrations in MANIFEST

1.0.0

• Initial release