Skip to main content

​
Install the Package

1

Install via pip or poetry

Choose your preferred package manager to install Django Admin Tabs:
pip install django-admin-tabs
The package includes all necessary templates and CSS static files.
2

Add to INSTALLED_APPS

Add django_admin_tabs to your INSTALLED_APPS setting in your Django settings file:
settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    # Add django_admin_tabs
    'django_admin_tabs',
    
    # Your other apps
    'myapp',
]
Make sure to place django_admin_tabs before your custom apps to ensure proper template resolution.
3

Collect static files (production only)

If you’re deploying to production, collect static files to ensure the CSS files are properly served:
python manage.py collectstatic
This step is only necessary for production deployments. During development, Django’s runserver command automatically serves static files.
4

Verify installation

You can verify the installation by checking if the package is importable:
python manage.py shell

>>> from django_admin_tabs import AdminTab, AdminChangeListTab, TabbedModelAdmin
>>> print("Django Admin Tabs installed successfully!")
If no errors occur, the installation is complete.

​
Compatibility

​
Python and Django Versions

Django Admin Tabs requires:
  • Python: 3.8 or higher
  • Django: 3.2 or higher
Older versions of Python or Django are not supported. Ensure your environment meets these minimum requirements before installing.

​
Third-Party Admin Libraries

Django Admin Tabs is compatible with popular Django admin extensions:
If you’re using other admin libraries and encounter compatibility issues, please report them on the GitHub repository.

​
What’s Included

When you install Django Admin Tabs, you get:
  • Three main classes: AdminTab, AdminChangeListTab, and TabbedModelAdmin
  • Custom templates: Pre-built templates for tabbed interfaces
  • CSS styles: Styling that integrates seamlessly with Django’s default admin theme
  • No JavaScript dependencies: Everything works with plain Django admin

​
Next Steps

Quick Start Guide

Learn how to create your first tabbed admin interface

Core Concepts

Understand the main components of Django Admin Tabs

Build docs developers (and LLMs) love

Get started for freeTalk to us