Soft delete for Django ORM, with support for undelete.
Python HTML
Latest commit aebb1f3 Jul 28, 2016 @scoursen version
Failed to load latest commit information.
softdelete hotfix for admin site Jul 28, 2016
.gitignore Added support for testing in a standalone django app Aug 28, 2011
LICENSE Added LICENSE file Oct 28, 2011 Markdownify the README Jan 15, 2016 version Jul 28, 2016


Soft delete for Django ORM, with support for undelete.

This project provides undelete of soft-deleted objects, along with proper undeletion of related objects.

Inspired by


  • Django 1.7
  • django.contrib.contenttypes


There are simple templates files in templates/. You will need to add Django's egg loader to use the templates as is:


Add the project softdelete to your INSTALLED_APPS for through-the-web undelete support.


How It Works

Central to the ability to undelete a soft-deleted model is the concept of changesets. When you soft-delete an object, any objects referencing it via a ForeignKey, ManyToManyField, or OneToOneField will also be soft-deleted. This mimics the traditional CASCADE behavior of a SQL DELETE.

When the soft-delete is performed, the system makes a ChangeSet object which tracks all affected objects of this delete request. Later, when an undelete is requested, this ChangeSet is referenced to do a cascading undelete.

If you are undeleting an object that was part of a ChangeSet, that entire ChangeSet is undeleted.

Once undeleted, the ChangeSet object is removed from the underlying database with a regular ("hard") delete.


Can be tested directly with the following command: test softdelete --settings="softdelete.settings"