Creating a New Role

Unlike MODX Evolution, permissions are not tied directly to Roles in Revolution. The purpose of Roles is to define each user's authority level in a User Group. Users in each group will inherit the permissions of users in the group with higher authority numbers (lower authority numbers = greater authority). The admin Super User always has a role with an authority number of 0. That means that the admin Super User will inherit all permissions given to all other users in the group.

Each role can only have one authority number and that number will apply wherever that role is used. The authority numbers are completely arbitrary, but should be planned so that users with more authority will have roles with lower numbers. It's a good idea to leave some gaps between the numbers you use in case you want to create intermediate roles later. Note that users can have different roles (and therefore different authority numbers) in each User Group they belong to.

Here are the steps for creating a new Role:

  1. Go to Security | Access Controls
  2. Click on the "Roles" tab if it is not the current tab
  3. Click on the "Create New" button
  4. Enter a Name, Authority level, and Description for the Role
  5. Click on the Save button in the dialog

Although you can assign a role for each user later, it will save you time and trouble if you create a role for your users before adding them to a User Group.

Security Resources at Bob's Guides


My book, MODX: The Official Guide - Digital Edition is now available here. The paper version of the book may still be available from Amazon.

If you have the book and would like to download the code, you can find it here.

If you have the book and would like to see the updates and corrections page, you can find it here.

MODX: The Official Guide is 772 pages long and goes far beyond this web site in explaining beginning and advanced MODX techniques. It includes detailed information on:

  • Installing MODX
  • How MODX Works
  • Working with MODX resources and Elements
  • Using Git with MODX
  • Using common MODX add-on components like SPForm, Login, getResources, and FormIt
  • MODX security Permissions
  • Customizing the MODX Manager
  • Using Form Customization
  • Creating Transport Packages
  • MODX and xPDO object methods
  • MODX System Events
  • Using PHP with MODX

Go here for more information about the book.

Thank you for visiting

  —  Bob Ray