Skip to content
A django app for role based permissions.
Python Shell
Branch: master
Clone or download


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 until the latest.

Version 2.x now supports multiple roles!


Documentation is available at:

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

Version 1.x support

No new features will be added to version 1.x, neither is it going to be officially supported. However, there's still 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 submitting a pull request. To run tests, install tox and run it in the command line from this project's folder:

$ tox


If you have any questions or need help, please send an email to:

Commercial Support

alt text

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

Copyright (c) 2019 Vinta Serviços e Soluções Tecnológicas Ltda. MIT License

You can’t perform that action at this time.