Skip to main content
Admin & security

Creating custom roles

Create your own roles that hold exactly the permissions you choose, and give them to users.

Written By Karl

Last updated 2 days ago

Besides the three system roles (Administrator, Manager and Employee), you can create your own roles. A custom role holds exactly the permissions you tick, and nothing else. For example, you can create a role for an HR partner who needs to see employee profiles but not pay.

Who can do this: Administrators who can manage users across the whole organisation.

Where: Settings β†’ Organization β†’ Users & roles β†’ Roles & Permissions

Create a role

  1. Select New role.

  2. Enter a Name and, if you like, a Description.

  3. Choose the Level. The level grants nothing by itself. People who hold the role can hand out only roles at or below its level.

  4. Tick each permission the role should hold. Where a permission can be narrowed, choose its scope in the menu next to it.

  5. Select Create role.

Give someone a custom role

Custom roles appear wherever you choose a role: when you invite a user, when you change a user's role with Edit Role, and when you give someone access to an entity.

Check who holds a role

  1. Select the role under Roles & Permissions.

  2. Under Members with this role, select View access next to a person to see everything they can reach.

Edit or delete a role

  1. Select the role under Roles & Permissions.

  2. Change what you need and select Save, or select Delete role.

You can't delete a role that a user, an entity grant or a pending invitation still holds. Give those people another role first.

Good to know

  • The system roles are locked and can't be edited.

  • You can only create, edit or hand out a role that holds no more access than you have yourself.

  • A role that someone holds keeps its level.

  • Only an Administrator can be the primary owner, so a custom role can't hold that position.

  • Changes to roles are recorded in the audit log.

  • Before you roll a new role out, use View access to check what a person with it can see.