django-admin-autocomplete-filter

What it is and what it does

Django Admin Autocomplete Filter is a Django app that replaces standard dropdown list filters in the admin panel with searchable autocomplete widgets powered by select2. It leverages Django's built-in autocomplete_fields feature to load filter options asynchronously, making it easier to filter large datasets without loading all options upfront.

The package provides filter classes that you attach to a model admin's list_filter, along with a factory function for quick filter creation. It supports custom search views for fine-grained control over results, custom widget text rendering, and integration with Grappelli. The single runtime dependency is django itself, and installation is straightforward via pip.

Use it for:

• Filter album records by artist in a large music database without loading thousands of artist names into memory.
• Create a searchable foreign key filter in admin for any model with a related object that has many instances.
• Customize autocomplete results with business logic (e.g., ordering, permission checks) via a custom search view.
• Render filter widget text differently from the model's default string representation using custom configuration.
• Speed up admin list page load times by deferring option loading until the user interacts with the filter.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds autocomplete-based filtering to Django admin list views, replacing standard dropdown filters with searchable select2 widgets for foreign key and related fields.

Yes, if you are using Django >= 2.0 and need better filtering UX in the admin panel. The package is stable and has no known vulnerabilities, but be aware that maintenance is dormant—last release was 2021-09-11—so do not expect bug fixes or support for very recent Django versions. It is well-suited for existing projects that need a quick improvement to admin filtering without custom development.

Install

django-admin-autocomplete-filter on PyPI

pip install django-admin-autocomplete-filter

uv add django-admin-autocomplete-filter

poetry add django-admin-autocomplete-filter

Installing django-admin-autocomplete-filter

Before you install

Low friction install with a single runtime dependency on django. Maintenance is dormant—last release was 2021-09-11 and last commit 2024-04-16, so expect no active bug fixes or feature development, though the codebase remains stable.

License in practice

Licensed under GNU Lesser General Public License v3 (LGPLv3), a copyleft license. You may use and modify the package freely, but any derivative work must also be licensed under LGPLv3 or compatible terms.

Quickstart

pip install django-admin-autocomplete-filter

# In settings.py, add to INSTALLED_APPS:
# 'admin_auto_filters'

# In admin.py:
from django.contrib import admin

class ArtistFilter:
    title = 'Artist'
    field_name = 'artist'

class AlbumAdmin(admin.ModelAdmin):
    list_filter = [ArtistFilter]

Requires Django >= 2.0. The related model must have search_fields defined in its ModelAdmin for autocomplete to work.

Verify before relying

• Whether the package works with Django versions released after 2021-09-11 (latest release date).
• Compatibility with modern Python versions beyond 3.6 (classifiers list only 3.5 and 3.6).
• Current status of Grappelli integration support.

Package facts

Evidence: django_admin_autocomplete_filter-0.7.1-py3-none-any.whl

Tags

More Python Modules packages