---
id: wagtail-modeladmin
version: "2.4.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# wagtail-modeladmin — Add any model in your project to the Wagtail admin. Formerly wagtail.contrib.modeladmin.

License: permissive · Maintenance: active · Downloads: 134.4K/mo

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

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

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 134.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

wagtail admin model management, django model admin wagtail, add models to wagtail admin, wagtail modeladmin interface, wagtail contrib modeladmin, manage django models in wagtail, wagtail-admin, django-integration

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