Skip to main content

Always have exactly one instance of a model.

Project description

Single Instance Model


We use Django for a lot of different things including CMS-style projects. In a CMS-style project, the user often needs to be able to just modify some data that shows up on the site. Maybe it's the content of a page.

The concept is simple: There's always going to be exactly one instance of this model.


To install, pip install django-single-instance-model.



from django.db import models
from single_instance_model.models import SingleInstanceModel

class AboutUs(models.Model, SingleInstanceModel):
    text = models.TextField(max_length=2000)


from django.contrib import admin
from single_instance_model.admin import SingleInstanceModelAdmin
from . import models

class AboutUsAdmin(SingleInstanceModelAdmin):


This works by executing code every time a database connection is established. It's a simple check to create the instance of the model if it doesn't exist.. but just be aware.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-single-instance-model, version 1.0.6
Filename, size File type Python version Upload date Hashes
Filename, size django_single_instance_model-1.0.6.tar.gz (2.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page