Unfold - Modern Django admin

A modern Django admin theme for building dashboards, internal tools, and business applications

Live demo · Documentation · Discord · PyPI

Quickstart

Install the package

uv add django-unfold

Add Unfold to INSTALLED_APPS

INSTALLED_APPS = [
    "unfold",  # First in the list
    # ...
]

Use Unfold's ModelAdmin

from django.contrib import admin
from unfold.admin import ModelAdmin


@admin.register(MyModel)
class MyModelAdmin(ModelAdmin):
    pass

Why Unfold?

• Django native - Built on django.contrib.admin, preserving familiar models, permissions, and conventions.
• Incremental adoption - Introduce Unfold gradually without rebuilding your existing admin.
• Built for real applications - Designed for dashboards, internal tools, backoffice systems, and workflows.

Features

• Modern interface - Responsive Tailwind CSS design with dark mode, customizable colors, layout options, and other visual settings for a polished admin experience.
• Dashboards and components - Build custom dashboards and admin pages using reusable cards, charts, buttons, and other UI components for data-rich interfaces.
• Advanced filtering - Dropdown, autocomplete, text, numeric, date range, checkbox, radio, and facet filters for more powerful and flexible changelists.
• Flexible actions - Add global, row-level, detail, submit, and dropdown actions with custom permissions, styles, and flexible placement options across the admin.
• Navigation and tabs - Customize the sidebar and organize models, fieldsets, and inlines using flexible tab navigation and layout options for complex interfaces.
• Enhanced forms and inlines - Conditional fields, sortable and paginated inlines, WYSIWYG editing, ArrayField widgets, and django-crispy-forms support for richer admin forms.
• Third-party integrations - Built-in support for popular Django packages including django-import-export, django-guardian, django-simple-history, django-constance, and more.

Explore all features

Third-party package support

• django-celery-beat - Integration guide
• django-constance - Integration guide
• django-guardian - Integration guide
• django-hijack - Integration guide
• django-import-export - Integration guide
• django-json-widget - Integration guide
• django-location-field - Integration guide
• django-money - Integration guide
• django-reversion - Integration guide
• django-reversion-compare - Integration guide
• django-simple-history - Integration guide
• django-waffle - Integration guide
• djangoql - Integration guide

Credits

• Tailwind CSS - Licensed under the MIT License.
• Material Symbols - Licensed under the Apache License 2.0.
• Inter - Licensed under the SIL Open Font License 1.1.
• Chart.js - Licensed under the MIT License.
• Alpine.js - Licensed under the MIT License.
• HTMX - Licensed under the BSD 2-Clause License.
• Trix - Licensed under the MIT License.
• Jedison - Licensed under the MIT License.