YouTrack Server
 
2019.2
Get YouTrack Standalone
You are viewing the documentation for an earlier version of YouTrack Server. View this page in the current documentation
  1. Administration
  2. Access Management
  3. Roles
  4. Create and Edit Roles

Create and Edit Roles

Last modified: 17 December 2019

If you want to create a custom set of permissions that are available to a group or user account, you can create new roles or edit the permissions that are assigned to an existing role.

If you want to create a role that is similar but not identical to an existing role, create the role with the Clone action instead. For more information, see Clone a Role.

Create a Role

If you want to provide specific access to a user or group, but do not want to modify any of the predefined roles, create a new role.

To create a new role:

tip

Requires permissions: Create Role, Read Service

  1. In the Access Management section of the Administration menu, select Roles.

  2. Click the New role button.

  3. Enter a name for the new role and click the Create button.

    • The settings page for the new role opens.

      New role general settings

  4. Enter an optional description of the new role.

  5. To configure the set of permissions that are available to the role, select the Permissions tab. Enable each permission that you want to assign to the role. For a detailed description of the controls on the Permissions tab, see Manage Permissions.

    • All changes to permissions are applied and saved automatically.

Once you have created and configured all of the roles that you want use, you can create or configure groups and assign roles to them on a per-project basis.

Edit an Existing Role

If there is a specific permission you would like to enable for users who are already assigned a specific role, you can modify an existing role.

To edit an existing role:

tip

Requires permissions: Update Role, Read Service

  1. In the Access Management section of the Administration menu, select Roles.

  2. Select a role from the list.

  3. In the settings page, edit the name or description.

  4. To configure the set of permissions that are available to the role, select the Permissions tab. Enable or disable specific permissions for the role. For a detailed description of the Permissions tab, see Manage Permissions.

    • All changes to permissions are applied and saved automatically.

You can restore a default role to its default permissions at any time. For more information, see Reset Roles to Default Permissions.