• Documentation

Manage project role membership

A Jira application 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 applications, project roles have specific members for each project. Users may play different roles in different projects.

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

For all of the following procedures, you must be logged in to Jira as a project administrator.

You can't edit project permissions or roles on the Free plan for Jira Software or Jira Work Management, and you can't configure issue-level security on any Free plan (including Jira Service Management). Find out more about how project permissions work in Free plans. To take advantage of Jira's powerful project permission management features, upgrade your plan.

Viewing project role members

  1. Go to your project and click Project settings

  2. Select People.

Assigning a user or group to a project role

  1. Go to your project and click Project settings

  2. Select People.

  3. Select Add people from the top right corner. 

  4. Search for the user or group you wish to add, and select the project role you wish to add them to. 
    Note that the Browse users and groups global permission is required to search for existing users or groups at this step. If you do not have this permission, you will need to specify the exact name or email address.

  5. Select Add.

Clean up unused project role permissions

Those with Jira Enterprise licenses can use the Site optimizer to remove old and unused project role permissions en masse. Find out how to use the Site optimizer.

Removing a user or group from a project role

  1. Go to your project and click Project settings

  2. Select People.

  3. In the user's or group's entry on the table, select Remove.

  • Because group membership can only be edited by users with the Administer Jira global permission, project administrators may therefore prefer to assign users, rather than groups, to their project roles.

  • A project role does not need to 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.

 

Still need help?

The Atlassian Community is here for you.