• To install django-waitinglist (no releases have been yet):

    pip install django-waitinglist
  • Add waitinglist to your INSTALLED_APPS setting:

        # ...
        # ...
  • See the list of Settings to modify the default behavior of django-waitinglist and make adjustments for your website.

  • Add waitinglist.urls to your URLs definition:

    urlpatterns = patterns("",
        url(r"^waitinglist/", include("waitinglist.urls")),
  • Since Django 1.7 the syncdb option is deprecated there is a fallback option migrate –run-syncdb To grant a user access the waitinglist management views, first ensure you’ve synced the database to create the waitinglist.manage_cohorts permission:

    from django.conf import settings
    from django.contrib.auth.models import Permission
    User = getattr(settings, 'AUTH_USER_MODEL', 'auth.User')
    user = User.objects.get(username="finnegan")
    permission = Permission.objects.get(codename="manage_cohorts")



This is bundled with Django. It is enabled by default with all new Django projects, but if you’re adding django-waitinglist to an existing project you need to make sure django.contrib.auth is installed.


We use django-appconf for app settings. It is listed in install_requires and will be installed when pip installs.


We use this app to handle all the sign up aspects. django-waitinglist is integrated to some hooks provided by this app.