---
id: djangoql
version: "0.19.1"
license: MIT License
license_treatment: permissive
maintenance: aging
---

# djangoql — DjangoQL: Advanced search language for Django

License: permissive · Maintenance: aging · Downloads: 753.2K/mo

## What it is and what it does

DjangoQL replaces Django admin's standard search with a query language that resembles Python syntax, allowing complex searches using logical operators (and, or), comparison operators (=, !=, <, >, <=, >=), and field traversal via dot notation. It supports string operations (startswith, endswith, contains via ~), date filtering by part, and list membership tests (in, not in), all with browser-based auto-completion.

The package integrates as a mixin and can be customized through schema definitions to limit searchable models and fields for performance or security. It includes a syntax help panel and can coexist with standard search via a checkbox toggle. Custom search fields allow annotation-based queries and fully custom search logic.

Use it for:

- Replace basic admin search with a powerful query interface for filtering complex model hierarchies
- Define restricted search schemas to prevent performance issues or expose only safe fields to user groups
- Build custom search fields that query annotated querysets, such as counting related objects
- Enable date-based filtering by month or year without requiring exact date ranges
- Provide auto-completion suggestions for foreign key and choice fields to guide users through valid values

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

DjangoQL provides an advanced search query language for Django models with auto-completion, supporting logical operators, field joins, and complex filtering through a Python-like syntax.

Yes, with conditions. DjangoQL carries no known vulnerabilities, has low install friction, and the repository shows active maintenance with 1138 stars and recent commits. However, the aging status (199 days since last release) means you should verify compatibility with your specific Django version before adopting. Best suited for teams that need powerful search in Django admin and can tolerate a slower release cadence.

## Install

pip install djangoql
uv add djangoql
poetry add djangoql

## Installing djangoql

Before you install: Low install friction with a single runtime dependency (ply). Maintenance status is aging—last release was 199 days ago, but the repository remains active with 1138 stars and no archived status.

License in practice: MIT License permits commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart:

pip install djangoql

# In settings.py, add to INSTALLED_APPS:
INSTALLED_APPS = ['djangoql', ...]

# In admin.py:
from djangoql.admin import DjangoQLSearchMixin

@admin.register(YourModel)
class YourModelAdmin(DjangoQLSearchMixin, admin.ModelAdmin):
    pass

Verify before relying:

- Whether the aging maintenance status (199 days since last release) affects stability for current Django versions
- Performance characteristics when searching large querysets with complex nested field joins
- Compatibility with Django versions beyond 6.0 mentioned in the description

## Package facts

- License: MIT License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 753.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django admin search language, advanced django model filtering, django query syntax with autocomplete, django search with logical operators, django admin search enhancement, complex model queries, field join search, django-admin, search-query-language, autocomplete

[View on SkillFed](https://skillfed.io/packages/djangoql) · [View on PyPI](https://pypi.org/project/djangoql/)