• You have a Django project installed.

  • You need to handle different types of users (for instance an Actor, a Producer, a Director) that will all inherit from the user, but will have different properties.

  • You want to handle them from the admin.

Prerequisites (~45min)


  • You have a basic user model with a name.

  • You want to create another type of user, a Mayor that has a City (the city is a foreign key to a City model).

  • You do not want to override the classic user model.

  • You want to create a Mayor from the admin

  • You want the newly created Mayor to be part of the Staff (Staff User can access the admin, but they are not SuperUser)


Add the Mayor model (5 min)

  • In the file, where the User is defined, create a new class that inherits the User

# You should have the User in the same file, or from app.models import User
from django.db import models
from django.contrib.auth.models import User

class Mayor(User):
    city = models.ForeignKey('')

    class Meta:
        verbose_name = "Mayor"
  • Create the migration file: ./ makemigrations or docker-compose run django_container_name ./ makemigrations

  • Run the migration: ./ migrate or docker-compose run django_container_name ./ migrate

Check 1: Run the show migration command to see the new one ./ showmigrations

Create a Mayor from the admin (5 min)

  • In the, where the User model is added admin.register(User)

  • Add the following:

from .models import Mayor
from django.contrib.auth.admin import UserAdmin

class MyMayorAdmin(UserAdmin):

Check 1: You now see the Mayor in the admin. But all the forms (form to add a Mayor, form to change/update a Mayor) are the same as for the regular User.

Override the admin form to add a Mayor (10 min)

  • In the when you declared your MyMayorAdmin class, you can choose the fields you want to display in the form by overriding the add_fieldsets property. You can readme more about add_fieldset here:

  • You need to know the fields you want to display. username, password1 and password2 are default fields of the "user admin add form"

  • In our case:

from .models import Mayor
from django.contrib.auth.admin import UserAdmin

class MyMayorAdmin(AuthUserAdmin):
    add_fieldsets = (
            ('User Profile', {'fields': ('username', 'city', 'password1', 'password2')}),

Check 1: You now see the city field in the "add new mayor" form.

Give admin property to mayor user (10 min)

  • You can manually set a user to be part of the staff, you can also override the save method of the AddForm so it changes the property is_staff to True

  • First create a form that inherits the AddUserForm and override the save method (see overriding custom model method):

from django.contrib.auth.forms import UserCreationForm

class MyMayorCreationForm(UserCreationForm):

    class Meta(UserCreationForm.Meta):
        model = Mayor

    def save(self, commit=True):
        user = super().save(commit=False)
        user.is_staff = True
        if commit:
        return user
  • Then use this form in the MyMayorAdmin class:

class MyMayorAdmin(AuthUserAdmin):
    add_form = MyMayorCreationForm

Check 1: When I create a mayor, I see that it is staff user in the detail view of the mayor.

Last updated