jmb.filter is a fork of django-filter whose main goal is to make life easy integrating django_filter in the django admin interface creating advanced search forms based on a description similar to search_list definition.

jmb.filter is a reusable Django application for allowing users to filter querysets dynamically.

Documentation on thux-site.

Original documentation on read the docs


  • Python 2.7+
  • Django 1.4+


Install using pip:

pip install jmb.filter

Or clone the repo and add to your PYTHONPATH:

hg clone


jmb.filter can be used for generating interfaces similar to the Django admin’s list_filter interface. It has an API very similar to Django’s ModelForms. For example, if you had a Product model you could have a filterset for it with the code:

import jmb.filters

class ProductFilter(jmb.filters.FilterSet):
    class Meta:
        model = Product
        fields = ['name', 'price', 'manufacturer']

And then in your view you could do:

def product_list(request):
    filter = ProductFilter(request.GET, queryset=Product.objects.all())
    return render_to_response('my_app/template.html', {'filter': filter})