This library is lacking a maintainer! I'm not actively using it any longer, which means that it is only getting the most basic fixes.

If you would like to take over the project, please get in contact. (Providing fixes for the existing issues would be a good start for showing your ability to take it on :-).


This library provides filters similar in some ways to list_filter and date_hierarchy in Django's admin, but for use outside the admin. Importantly, it also includes result counts for the choices. It is designed to be very easy to get started with.


Just install as a Python library.

PyPI page: http://pypi.python.org/pypi/django-easyfilters


See the docs/ directory, especially docs/overview.rst

Also hosted here: http://packages.python.org/django-easyfilters And here: https://django-easyfilters.readthedocs.org/en/latest/


A small demo app is included, see the instructions in docs/develop.rst

A (currently) live example can be seen at:



The library is in a useful state and is used in production. Test coverage is extensive. Feedback regarding API or features is very welcome!


File bugs/feature request in the 'issues' in BitBucket:

  • #2 it's possible to write a filter by field in related object? (new)
  • #10 Boolean fields choices not localized (new)
  • #8 Choices count not always accurate (new)
  • #4 filterlabel tightly-coupled to verbose_name (new)

Or drop me an email, I always like to hear when people are using my stuff.


  • Possible: ability to specify 'defaults' attribute for FilterSet
  • Allow the automatic 'page' resetting to be customized