A django app for role based permissions.
Latest commit cd0a61c Oct 28, 2017 @filipeximenes filipeximenes Merge pull request #74 from vintasoftware/django-versions
Adds information about supported Django versions



Build Status Current version at PyPI Supported Python Versions

django-role-permissions is a django app for role based permissions. It's built on top of django contrib.auth user Group and Permission functionalities and it does not add any other models to your project.

django-role-permissions supports Django versions from 1.5 till the lattest.

Version 2.x now supports multiple roles!


Documentation is available at:


If you are still using an 1.x version the old documentation is at:


Version 1.x support

No new features will be added to version 1.x neither it's going to be officially supported. Although, there's a 1.x branch. PRs and bug fixes are welcome there and we may push new versions to PyPI.

2.x release notes

There are major changes from version 1.x to 2.x. Here are some of them worth noting:

  • Django role permissions now supports multiple role attribution
  • Function names have changed to adapt to multiple roles
  • Import paths have changed

A special thanks to @kavdev for working on multiple role support.

Running tests

This packages uses tox to run tests on multiple evironments, please make sure they are passing before submiting a pull request. To run tests, install tox and run it in the command line from this project folder:

$ tox


If you have any questions or need help, please send an email to: contact@vinta.com.br

Commercial Support

This project, as other Vinta open-source projects, is used in products of Vinta clients. We are always looking for exciting work, so if you need any commercial support, feel free to get in touch: contact@vinta.com.br