wagtail-modeladmin

What it is and what it does

Wagtail ModelAdmin extends Wagtail's admin interface to manage arbitrary Django models alongside Wagtail's built-in content types. Originally part of Wagtail core (wagtail.contrib.modeladmin), it was extracted into a standalone package and is now in maintenance mode, receiving bug fixes and compatibility updates but no new features.

The package lets you register any Django model to appear in the Wagtail admin, providing a familiar admin interface for non-Wagtail models without leaving the Wagtail ecosystem. It depends only on Wagtail and supports modern Python versions (3.10–3.14) and recent Django/Wagtail releases. The maintainers recommend migrating to Wagtail's built-in features for new projects, but this package remains stable for existing codebases that rely on it.

Use it for:

• Manage non-content Django models (e.g., settings, configurations, user roles) from within the Wagtail admin interface
• Migrate legacy Django admin interfaces into Wagtail without rewriting model management code
• Provide a unified admin panel for teams working with both Wagtail pages and custom application models
• Maintain backward compatibility in projects that previously used wagtail.contrib.modeladmin before it was extracted

Worth the install?

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

Adds Django model administration interfaces to Wagtail's admin panel, allowing you to manage any project model alongside Wagtail's native content.

Yes, if you have an existing Wagtail project that needs to manage Django models alongside Wagtail content and you're not starting a new project. The package is stable, actively maintained for compatibility, and has low install friction. However, for new projects, evaluate Wagtail's built-in features first, as this package is in maintenance mode and will not receive new functionality.

Install

wagtail-modeladmin on PyPI

pip install wagtail-modeladmin

uv add wagtail-modeladmin

poetry add wagtail-modeladmin

Installing wagtail-modeladmin

Before you install

Low friction install with a single runtime dependency on Wagtail. Actively maintained with recent releases; last commit 2026-06-07. In maintenance mode—bug fixes and compatibility updates only, no new features planned.

License in practice

BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; you must include the license text in distributions.

Quickstart

pip install wagtail-modeladmin

# In your Django settings.py INSTALLED_APPS:
INSTALLED_APPS = [
    # ...
    "wagtail_modeladmin",
]

# Then register models via ModelAdmin classes (see documentation)

Requires Wagtail 7.0 or 7.3, Django 5.2 or 6.0, and Python 3.10 or later

Verify before relying

• Whether migration path from wagtail.contrib.modeladmin is seamless or requires code changes
• Performance characteristics when managing large numbers of models or records

Package facts

Evidence: wagtail_modeladmin-2.4.0-py3-none-any.whl

Tags

More Dynamic Content packages