django-admin-rangefilter

What it is and what it does

django-admin-rangefilter is a Django app that extends the admin interface with specialized filter widgets for date, datetime, and numeric ranges. It integrates directly into Django's ModelAdmin list_filter configuration, allowing developers to replace standard dropdown filters with interactive range pickers that let users select start and end dates or values. The package has no runtime dependencies beyond Django itself.

The package provides several filter builders—DateRangeFilterBuilder, DateTimeRangeFilterBuilder, NumericRangeFilterBuilder, and DateRangeQuickSelectListFilterBuilder—that can be attached to model fields in the admin. It also integrates with django-csp when present to add nonces to inline styles and scripts for Content-Security-Policy compliance. Installation is straightforward: add the package to INSTALLED_APPS and configure filters on your ModelAdmin classes.

Use it for:

• Filter blog posts or articles by creation date range in the admin interface.
• Allow admins to view transactions or events within a specific numeric value range.
• Provide quick-select date range options for common filtering tasks.
• Combine datetime range filters with custom default start and end dates for admin workflows.

Worth the install?

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

Adds date range, datetime range, and numeric range filters to Django's admin interface, allowing users to filter model lists by custom date or value ranges.

Yes. The package is actively maintained, has no external dependencies, carries a permissive MIT license, and solves a common Django admin UX problem. It's in the top 5000 PyPI packages by download volume and has been stable since its early releases.

Install

django-admin-rangefilter on PyPI

pip install django-admin-rangefilter

uv add django-admin-rangefilter

poetry add django-admin-rangefilter

Installing django-admin-rangefilter

Before you install

Low friction installation with no runtime dependencies. Actively maintained with recent releases.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install django-admin-rangefilter

Add 'rangefilter' to INSTALLED_APPS in settings.py

In admin.py:
from rangefilter.filters import DateRangeFilterBuilder
from django.contrib import admin
from .models import Post

@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_filter = (("created_at", DateRangeFilterBuilder()),)

Requires Django 1.11+ and Python 3.6+

Verify before relying

• Whether the range filter UI works with all modern Django admin themes and customizations.
• Performance impact when filtering large datasets with many range filter instances.

Package facts

Evidence: django_admin_rangefilter-0.14.0-py2.py3-none-any.whl

Tags

More Utilities packages