---
id: django-admin-autocomplete-filter
version: "0.7.1"
license: unclear
license_treatment: copyleft
maintenance: dormant
---

# django-admin-autocomplete-filter — A simple Django app to render list filters in django admin using autocomplete widget

License: copyleft · Maintenance: dormant · Downloads: 584.0K/mo

## 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 above — 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

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

- License: not declared (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 584.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django admin autocomplete filter, select2 list filter django, searchable admin filters django, autocomplete foreign key filter, django admin search widget, dynamic admin list filter, django-admin, filtering, ui-widget

[View on SkillFed](https://skillfed.io/packages/django-admin-autocomplete-filter) · [View on PyPI](https://pypi.org/project/django-admin-autocomplete-filter/)