---
id: django-admin-rangefilter
version: "0.14.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# django-admin-rangefilter — django-admin-rangefilter app, add the filter by a custom date range on the admin UI.

License: permissive · Maintenance: active · Downloads: 1.4M/mo

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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django admin date range filter, django admin numeric range filter, django admin custom filters, django admin date picker, django admin filtering ui, django-admin-ui, filtering

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