modelsearch

What it is and what it does

Django ModelSearch is a search indexing layer for Django that lets you index your models into Elasticsearch, OpenSearch, or your existing database (PostgreSQL FTS, MySQL FTS, MariaDB FTS, SQLite FTS5) and then query them through the familiar Django ORM. Instead of writing raw search queries, you call `.search()` on a QuerySet just like you would `.filter()`, and the library translates that into the appropriate backend query.

It was built into Wagtail CMS since 2014 and extracted as a standalone package in March 2025. The library handles index synchronization via Django signals, supports zero-downtime index rebuilds using aliases, and integrates with Django's pagination and filtering ecosystem. You define searchable fields on your models with optional per-field boosting, filter fields for fast faceting, and can pull content from related models into the index.

Use it for

• Build a product catalog search that works across PostgreSQL, Elasticsearch, or SQLite without rewriting query logic for each backend.
• Add autocomplete and fuzzy search to a Django admin or user-facing search form with faceted results.
• Index large text fields (articles, documentation, logs) and search them with phrase queries and field-specific relevance tuning.
• Migrate search from database FTS to Elasticsearch for performance without changing application code.
• Combine full-text search with Django filters and pagination in a single QuerySet chain.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

modelsearch on PyPI

Before you install

Low friction: pure Python wheel with only Django and django-tasks as runtime dependencies. Actively maintained since March 2025 with recent commits and no known vulnerabilities.

Requires Python 3.10+; if using PostgreSQL, django.contrib.postgres must be in INSTALLED_APPS; run `django-admin rebuild_modelsearch_index` to initialize indexes.

License in practice

BSD-3-Clause (permissive): you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install modelsearch

# settings.py
INSTALLED_APPS = [
    'modelsearch',
    'django.contrib.postgres',  # if using PostgreSQL
]

# models.py
from modelsearch import index
from modelsearch.queryset import SearchableQuerySetMixin

class SongQuerySet(SearchableQuerySetMixin, models.QuerySet):
    pass

class Song(index.Indexed, models.Model):
    name = models.TextField()
    search_fields = [index.SearchField('name', boost=2.0)]
    objects = SongQuerySet.as_manager()

# Then search
Song.objects.search("query")

Package facts

Evidence: modelsearch-1.3.2-py3-none-any.whl

Tags

More Python Modules packages

See also django-elasticsearch-dsl · django-haystack · sqlalchemy-searchable · django-ordered-model · django-opensearch-dsl · typesense · django-filter · django-mysql · Whoosh · djangoql