Documentation for JIRA 6.3 EAP developer (EAP) releases only. Not using this? See below:
(JIRA 6.2.x documentation | JIRA OnDemand documentation | earlier versions of JIRA)

Skip to end of metadata
Go to start of metadata

A JIRA project role is a flexible way to associate users and/or groups with a particular project.

Unlike groups, which have the same membership throughout JIRA, project roles have specific members for each project. Users may play different roles in different projects.

(info) This page contains instructions for managing membership of existing project roles. For information on creating and using project roles, please see Managing project roles.

On this page:

Viewing project role members

To see which users and groups belong to each project role for a particular project:

  1. Log in to JIRA as a project administrator.
  2. Choose > Projects. The 'Project Summary' page (see Defining a Project) for your selected project is shown.
    (tick) Keyboard shortcut: g + g + start typing project
  3. Choose Roles in the left menu. The Roles page is displayed, from where you can manage the project role membership as described below.
    Screenshot: The 'Roles' page

Assigning a user to a project role

  1. Open the Roles page as described in 'Viewing project role members' above.
  2. Hover over the Users column for the project role in which you are interested and click the yellow box which appears. The users and groups will become editable.
  3. Type the name of the user(s) you wish to add to this project role.
    (info) The Browse Users global permission is required to search for users in the Users column. If you do not have this permission, you will need to specify the exact name of the user(s), followed by the 'Enter' key after each user specified.
  4. Click the Update button.

Removing a user from a project role

  1. Open the Roles page, as described in 'Viewing project role members' above.
  2. Hover over the Users column for the project role in which you are interested and click the yellow box which appears. The users and groups will become editable.
  3. Click the x next to the name of the user(s) you wish to remove from this project role.
  4. Click the Update button.

Assigning a group to a project role

  1. Open the Roles screen, as described in 'Viewing project role members' above.
  2. Hover over the Groups column for the project role in which you are interested and click the yellow box which appears. The users and groups will become editable.
  3. Type the name of the group(s) you wish to add to this project role.
    (info) The Browse Users global permission is required to search for groups in the Groups column. If you do not have this permission, you will need to specify the exact name of the group(s), followed by the 'Enter' key after each group specified.
  4. Click the Update button.
Icon

Since group membership can only be edited by users with the JIRA Administrator global permission, project administrators may therefore prefer to assign users, rather than groups, to their project roles.

Removing a group from a project role

  1. Open the Roles page, as described in 'Viewing project role members' above.
  2. Hover over the Groups column for the project role in which you are interested and click the yellow box which appears. The users and groups will become editable.
  3. Click the x next to the name of the group(s) you wish to remove from this project role.
  4. Click the Update button.
Icon

A project role need not have any users or groups assigned to it, although project administrators should be careful with this. Depending on how a project role is used (e.g. if the project's permission scheme is using project roles), it is possible that not having anyone in a particular project role could make some project activities unavailable.

2 Comments

  1. Anonymous

    OUr team added a new LDAP group to represent the separate admin and developer roles.  What is the best way to u[pdate all existing projects?

  2. Anonymous

    Hi,

    In previous versions, it was possible to know the email address of each user assigned to the Project Roles on the "People" screeen. Right now, it is only possible anymore, except for the Project Lead.

    Is there any alternative to see the email addresses?

    Regards