Skip to main content

Abstract

Learn how to add, edit, and delete roles in Maxsight. Includes steps to create roles, assign permissions, update role details, and remove roles when no users are assigned.

Roles control what users can see and do on your Maxsight account.

Roles can be applied to individual users or to teams. When you change a team's roles, the update applies to team members the next time they sign in.

Each role includes a set of permissions. Permissions provide the user or team members with different levels of access to areas of Maxsight. Learn more about individual permissions.

Prerequisites

  • Read and write access for the Manage users permission.

Add a role

To add a new role:

  1. Go to User Management > Roles.

  2. Select New role. The Add new role page is displayed.

    Add new role page
  3. Write the role's name in the Name field.

  4. To provide a short description of the role, write it in the Description field. If you leave this field blank, the description is displayed as No description provided.

  5. To add permissions to the role, select a permission to expand it, then select the type of access you’d like to grant, for example, Read-only or Read and write. By default, no permissions are granted. Learn what users can do with each permission.

    Selecting access type for Reports permissions
  6. Select Add new role. The role is displayed in the list of roles.

If you have Read and write access for the Manage users permission, you can assign the role to users and team members.

Edit a role

To edit a role:

  1. Go to User Management > Roles.

  2. Select the role you’d like to edit.

  3. To change the name, update the Name field.

  4. To change the description, update the Description field.

  5. To change permissions, select a permission to expand it, then select the type of access you’d like to grant, for example, Read-only or Read and write. Learn what users can do with each permission.

  6. Select Save changes. The role is updated. If you modified the permissions, users and team members see the changes immediately.

If a user or team member doesn’t see changes to their permissions, ask them to refresh their browser.

Delete a role

Roles can only be deleted if they're not assigned to any users.

To delete a role:

  1. Go to User Management > Users and remove the role from all users who have it assigned to them.

    User page with mouse hovering over the option to remove a user role.

    The number of users with the role assigned to them is displayed next to the role’s name in the Roles section. This must be displayed as 0 users before the role can be deleted.

    A role on the Roles page showing the number of users assigned to the role.
  2. Go to User Management > Roles and select the role you’d like to delete.

  3. Select Delete role. A confirmation dialog is displayed.

    Delete role confirmation dialog.
  4. Select Delete role. The role is removed from the list of roles and can no longer be assigned to users.

If the Delete role button is inactive, one or more users or teams have the role assigned to them. Edit the users and teams to remove the role, then repeat the steps to delete the role.

Additional information