Registering Models in the Admin

The Simplest Registration

Calling admin.site.register() with a model class is enough to get a fully working list/add/edit/delete interface for it, using Django's defaults.

Example: The Simplest Registration

This single line makes Book manageable from the admin dashboard.

from django.contrib import admin
from .models import Book

admin.site.register(Book)

Registering Multiple Models

You can register several models from the same app in one admin.py file, each with its own call.

Example: Registering Multiple Models

Both Book and Author now appear as separate sections in the admin dashboard.

from django.contrib import admin
from .models import Book, Author

admin.site.register(Book)
admin.site.register(Author)

Using the @admin.register Decorator

Instead of calling register() separately, you can decorate a ModelAdmin class with @admin.register(Model) -- useful once you start customizing the admin, covered in later topics.

Warning: Registering the same model twice (e.g. once via decorator and once via admin.site.register) raises django.contrib.admin.sites.AlreadyRegistered.

Example: Using the @admin.register Decorator

This registers Book using an empty ModelAdmin, equivalent to the plain register() call but ready for customization.

from django.contrib import admin
from .models import Book

@admin.register(Book)
class BookAdmin(admin.ModelAdmin):
    pass