Add users to a Jira project
15 min
By the end of this lesson, you’ll be able to:
- Assign project roles to match how your team works
- Add users to your Jira project
Add users to project roles
When you add users to your project, you need to grant them a role. Their role determines what they can see or do within a project. The process for adding roles is slightly different for company-managed and team-managed projects.
👇 Click the tabs below to see configuration steps for different project types.
To add users to roles in a team-managed project:
- In the sidebar, next to your project's name, click More actions (represented by •••), then Add people.
- Find users by their name or email.
- From the Role drop-down menu, choose a role.
- To limit the user to only viewing and commenting on work, select Viewer. The user doesn't need a Jira license.
- To make the user a collaborator who can add and edit work, select Member.
- To make the user a project admin, select Administrator.
- Click Add.
👇 You can also add people in the Access section of your project settings.
👇 View the video below to see how to assign project roles to team members.
👇 View the video below to see how to confirm project roles changes for a team member.
Create a new project role
For both team-managed and company-managed projects, you can create new project roles. However, for company-managed projects, only Jira admins can create new project roles through Jira administration settings. In team-managed projects, project admins can create custom roles as needed.
👇 Click the tabs below to see how to create new project roles for different project types.
To create a new role as a team-managed project admin:
- In the sidebar, next to your project's name, click More actions (represented by •••), then Project settings.
- In the sidebar, click Access.
- Click Manage roles.
- Click Create role.
- Name and describe the role clearly, then grant the necessary permissions. Optionally assign users to the role, then click Create.
Admins create custom roles to either restrict permissions or to enable additional permissions for a specific set of users.
👉 For example: Certain members on the Rover team need to be able to delete work items, which normally only administrators can do. The team does not want to grant full administrator permissions to these team members; they only need to be able to delete work items.
👇 Click the tabs below to learn more about what can be done in different project types to meet this requirement.
The project admin:
- Creates a custom project role (Work Managers) that only grants the ability to delete work items.
- Adds selected project users to the Work Managers custom role.