Managing Project Role Membership

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

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, and click the name of a project. 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.

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.

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.

Last modified on Mar 22, 2013

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.