Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Display django permissions in a tabular format that is user friendly, and highly customisable

Project Description

Display Django basic permissions (add, change & delete) in a tabular format that is user friendly, translatable and easy customized. If you have more customised permissions, the default FilteredSelectMultiple widget will also appear to handle those permissions.

Scroll down for some screen shots.


  • Permissions are displayed in the active language with app and model verbose_name.
  • Any extra custom permissions are displayed in the default admin widget for permissions.
  • Customize which apps, models to show in the permissions table. You can also set a exclude function for high-end customization.
  • RTL ready, Bootstrap ready.
  • Easy customize-able look.
  • Tested on Django 1.11
  • Tested on Python 2.7, 3.4 & 3.5


Django tabular permissions current version 1.1 supports only django 1.11 For earlier versions of django use django-tabular-permissions 1.0.9.


You can install django-tabular-permissions via Pypi:

pip install django-tabular-permissions


Simply add “tabular_permissions” to your INSTALLED_APPS setting like this:


then navigate to User and/or Group change form to see django-tabular-permissions in action.



Control which apps, models to show in the permissions table. By default tabular_permissions exclude contrib apps sessions , contenttypes and admin apps from showing their models in the permissions table. You can add (or override) those apps and/or specify models to exclude, like this:

    'app': [],
    'model': [],
    'function': 'tabular_permissions.helpers.TabularPermissionDefaultExcludeFunction',
                 # A dotted path to a class that implement ``__call__`` that takes model as an argument.
    'override': False # Set to True to override default behavior.

By default, just by including tabular_permissions in your installed_apps, the django.contrib.admin.UserAdmin (and GroupAdmin) are “patched” to include the tabular_permissions widget. If you have a custom UserAdmin, then set this option to False and make sure you either:

  1. Inherit from TabularPermissionsUserAdmin for User admin and from``TabularPermissionsGroupAdmin`` for group admin
  2. Inherit from UserTabularPermissionsAdminBase and GroupTabularPermissionsAdminBase before admin.ModelAdmin or UserAdmin/GroupAdmin,
  3. Set the user_permissions widget to tabular_permissions.widgets.TabularPermissionsWidget and remember to send a 3rd argument ‘permissions’ when in Group admin. See tabular_permissions.admin for information.

Default to ‘tabular_permissions/admin/tabular_permissions.html`. You can either extend or override this template for maximum control.


Default True. Till now (Feb 1 2016 - django 1.9), there is an inconsistency with proxy models permissions (ticket 11154) So in case you have proxy models and you create their permissions by hand (via this gist maybe) Turn off this option in order to correctly assign your newly created permissions via django-tabular-permissions widget.


Located at ‘static/tabular_permissions/tabular_permissions.js’, it have 3 responsibilities:

  1. Upon form submit, the checked permissions in the table are dynamically appended to the form default permission input so the backend can carry on its functionality normally and correctly.
  2. Add handlers for column and row select-all checkboxes.
  3. Add a class ‘related-widget-wrapper-user-permissions’ to the div.related-widget-wrapper that contains the table, it serves when you need to manipulate the table container.


Basic Demo

With Custom permission behaviour

RTL and localized

Enjoy and feel free to report any bugs or make pull requests.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-tabular-permissions-1.1.1.tar.gz (8.2 kB) Copy SHA256 Checksum SHA256 Source Nov 21, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting