By Shriful Islam · · 3 min read · 245 views
When you start a Django project, one of the most powerful features you get out-of-the-box is the Django Admin panel.
It allows you to:
Manage database records
Control users and permissions
Create, read, update, and delete data without writing a single line of HTML
In this article, we’ll explore how to use Django Admin effectively, from basic setup to advanced customization.
1. Make sure the in :
No comments yet. Start the conversation.
settings.pyINSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'blog', # Your app
]
2. Create a superuser to access the admin:
python manage.py createsuperuser
3. Run the development server:
python manage.py runserver
4. Access the admin panel at:
http://127.0.0.1:8000/admin/
Use the superuser credentials to log in.
By default, Django only shows models that you register in admin.py.
Example: blog/admin.py:
from django.contrib import admin
from .models import BlogPost, Comment
admin.site.register(BlogPost)
admin.site.register(Comment)
Now BlogPost and Comment appear in the admin panel.
Django Admin is highly customizable. You can:
Show only relevant columns in the list view:
class BlogPostAdmin(admin.ModelAdmin):
list_display = ('title', 'author', 'published_date', 'status')
admin.site.register(BlogPost, BlogPostAdmin)
Make it easier to find records:
class BlogPostAdmin(admin.ModelAdmin):
list_display = ('title', 'author', 'published_date', 'status')
list_filter = ('status', 'author')
search_fields = ('title', 'content')
Control default ordering:
class BlogPostAdmin(admin.ModelAdmin):
ordering = ('-published_date',)
Edit related models in the same page:
class CommentInline(admin.TabularInline):
model = Comment
extra = 1
class BlogPostAdmin(admin.ModelAdmin):
inlines = [CommentInline]
admin.site.register(BlogPost, BlogPostAdmin)
Django Admin is not just a CRUD interface; it also handles user permissions.
Groups → Assign multiple permissions
Users → Can be superuser, staff, or normal
Fine-grained control over add/change/delete permissions per model
Example:
from django.contrib.auth.models import Group, Permission
# Create a group with specific permissions
editors_group = Group.objects.create(name='Editors')
permission = Permission.objects.get(codename='change_blogpost')
editors_group.permissions.add(permission)
Django Admin can be styled and branded:
Django Grappelli → Modern theme
Django Suit → Sleek professional look
Custom CSS → Add logo, colors, or fonts
This helps when giving admin access to clients or non-technical staff.
Custom Actions → Add buttons to perform bulk actions
Custom Admin Views → Add analytics dashboards
Readonly Fields → Protect fields from being edited
Example: Bulk publish posts:
def make_published(modeladmin, request, queryset):
queryset.update(status='P')
make_published.short_description = "Mark selected posts as Published"
class BlogPostAdmin(admin.ModelAdmin):
actions = [make_published]
✔ Only give admin access to trusted users
✔ Keep list displays and filters simple for performance
✔ Use inlines wisely to avoid clutter
✔ Document any custom actions for team clarity
The Django Admin panel is a powerful feature that can save you weeks of work.
Once you understand:
Model registration
Customization
Permissions
Actions and inlines
You can build a robust management interface without writing custom views or forms.