Add users to a Jira space
15 min
By the end of this lesson, you’ll be able to:
- Assign space roles to match how your team works
- Add users to your Jira space
Add users to space roles
When you add users to your space, you need to grant them a role. Their role determines what they can see or do within a space. The process for adding roles is slightly different for company-managed and team-managed spaces.
👇 Click the tabs below to see configuration steps for different space types.
To add users to roles in a team-managed space:
- In the sidebar, next to your space'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 space admin, select Administrator.
- Click Add.
👇 You can also add people in the Access section of your space settings.
👇 View the video below to see how to assign space roles to team members.
Create a new space role
For both team-managed and company-managed spaces, you can create new space roles. However, for company-managed spaces, only Jira admins can create new space roles through Jira administration settings. In team-managed spaces, space admins can create custom roles as needed.
👇 Click the tabs below to see how to create new space roles for different space types.
To create a new role as a team-managed space admin:
- In the sidebar, next to your space's name, click More actions (represented by •••), then Space 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 space types to meet this requirement.
The space admin:
- Creates a custom space role (Work Managers) that only grants the ability to delete work items.
- Adds selected space users to the Work Managers custom role.