This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Django autocomplete light filters for django admin

Project Description

Django-autocomplete-light filters for django admin.

  • default select2 widget

  • widget with filter title as placeholder


This is extension for django-autocomplete-light so you need to install and configure it too.

Here will be minimum setup for example.

Refer to for more detailed instructions.


  • Install using pip

    pip install django-autocomplete-light dal_admin_filters
  • Update INSTALLED_APPS. You need too put django-autocomplete-light before admin

        ... other stuff there ...


  • Create autocomplete view

    • Let our models look like this

      class Country(models.Model):
          name = models.CharField(max_length=100, unique=True)
          def __str__(self):
      class Person(models.Model):
          name = models.CharField(max_length=100, unique=True)
          from_country = models.ForeignKey(Country)
          def __str__(self):
    • Then autocomplete view for country selection will be similar to next

      from your_countries_app.models import Country
      class CountryAutocomplete(autocomplete.Select2QuerySetView):
      def get_queryset(self):
          # Don't forget to filter out results depending on the visitor !
          if not self.request.user.is_authenticated():
              return Country.objects.none()
          qs = Country.objects.all()
          if self.q:
              qs = qs.filter(name__istartswith=self.q)
          return qs
  • Register view in

    from your_countries_app.views import CountryAutocomplete
    urlpatterns = [
  • Use filter in your

    from django.contrib import admin
    from your_countries_app.models import Country, Person
    from dal_admin_filters import AutocompleteFilter
    class CountryAdmin(admin.ModelAdmin):
    class CountryFilter(AutocompleteFilter):
        title = 'Country from'                    # filter's title
        parameter_name = 'from_country'           # field name - ForeignKey to Country model
        autocomplete_url = 'country-autocomplete' # url name of Country autocomplete view
    class CountryPlaceholderFilter(AutocompleteFilter):
        title = 'Country from'                    # filter's title
        parameter_name = 'from_country'           # field name - ForeignKey to Country model
        autocomplete_url = 'country-autocomplete' # url name of Country autocomplete view
        is_placeholder_title = True               # filter title will be shown as placeholder
    class PersonAdmin(admin.ModelAdmin):
        class Media:    # Empty media class is required if you are using autocomplete filter
            pass        # If you know better solution for altering from filter instance
                        #   - please contact me or make a pull request
        list_filter = [CountryFilter]

If setup is done right, you will see the Select2 widget in admin filter in Person’s changelist view.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
dal_admin_filters-0.1.7.tar.gz (5.7 kB) Copy SHA256 Checksum SHA256 Source Oct 27, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting