JetBrains Space Help

Manage Access to a Project

When you create a project you become the project's administrator, and it's up to you who will have access to that project and at what level.

Access to a project is provided on the membership basis, by adding a user to a Role that has a predefined set of permissions.

Each project comes with the following predefined Roles:

  • Project Admin — intended for project participants that should be allowed to manage access and configure project modules as well as contribute to the project.

  • Project Member — intended for project participants that contribute to the project on regular basis and are included in the Project Team.

  • Project Collaborator — intended for project participants that occasionally contribute to the project but are not considered part of the team. Collaborators have the same default permissions as project members but are not included in the Project Team.

  • Organization Member — defines what permissions the rest of Space users have in the project.

  • Automation Service — intended for automation services that access the project repositories.

Project Team is a collective name for all your project members, i.e. participants with the Project Member role. When you add a person to the Project Team, he or she becomes a Project Member.

You can assemble a Project Team either by picking individual members or by adding a team that already exists in the organization.

A Project Team assembled from individual members and therefore confined to the project can be extracted to the organizational level to become a part of your organization team directory.

The predefined Roles are configured to allow only Project Members, Project Admins, and Project Collaborators to contribute to the project, access its internal features, and modify data. However, you can edit these Roles or create a new one with a different variety of project access permissions. (Custom Roles available starting with Organization plan.)

Add members to the project

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

    If you Project Team already has members, you can add new ones to it (skip to this part). But if you're starting from scratch, you have the choice of either adding members individually or adding a team from the organization:

    projectTeamNew.png

Assemble a new Project Team by adding individual members

  1. Click Add members.

  2. Start typing the person's name into the text field or choose it from the drop-down list:

    assembleNewProjectTeam.png
  3. Repeat for each additional member and click Assemble when done:

    assembleNewProjectTeamDone.png

    All project members will be listed on the Team tab:

    projectTeamMembers.png

Add an existing team to the project

  1. Click Add team.

  2. Start typing the team's name into the text field or choose it from the drop-down list:

    addExistingTeamToProject.png
  3. Click Add.

    Members of the existing team will also become your project members and will be listed on the Team tab:

    existingTeamAddedToProject.png

Add new members to the Project Team

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. On the Teams tab, click Add member and start typing the person's name into the text field or choose it from the drop-down list:

    projectTeamAddMember.png

Add a collaborator to the project

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Go to the Collaborators tab.

  4. Click Add a team or a member and start typing the name into the text field or choose it from the drop-down list:

    addCollaboratorToProject.png

Add an administrator to the project

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Go to the Administrators tab.

  4. Click Add a team or a member and start typing the name into the text field or choose it from the drop-down list:

    addAdministratorToProject.png

Revoke access rights

You can revoke access permissions provided by a Role from any member, administrator or collaborator by removing a person from a corresponding list that denotes the Role.

  • Team (Project Member)

  • Collaborators (Project Collaborator)

  • Administrators (Project Admin)

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Choose a tab:

    • Team (Project Member)

    • Collaborators (Project Collaborator)

    • Administrators (Project Admin)

  4. Delete a person from the list:

    revokeProjectMembership.png

Extract a Project Team to organization

Let's say you've created a project and assembled a new team within that project. Now you want your team to have a common calendar so the members can collaborate more efficiently: instantly see who's absent, schedule meetings, receive notifications about teammates' activities. To achieve that, you need to extract this team to the organization, that is make it part of the organization team directory.

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Make sure each team member has a position. Click Set position, to assign one.

  4. In the top right corner, click menu-horizontal.png and choose Extract to organization:

    extractProjectTeamToOrganization.png
  5. Give the team a name and choose a parent team for it (if you don't want your team to be a top level).

  6. Click Extract.

    Your Project Team will be included in your organization team directory.

Configure project permissions

The table below lists the default permissions for each Role.

If you find the default permission arrangement unsatisfactory, you can edit the Roles by adding or removing certain permissions from them. You can also create a new custom Role with a different permission set. (Custom Roles available starting with Organization plan.)

See what permissions are included with the default Roles in the Roles comparison table.

To edit Roles

  1. Navigate to the project.

  2. On the project sidebar menu, choose Settings.

  3. On the Project Settings page, go to the Access tab.

    The Access page will be displayed.

  4. On the left pane, choose the Role that you want to edit and click Edit permissions:

    editProjectPermissionsTabs.png
  5. Edit permissions for the selected Role using checkboxes:

    editProjectPermissions.png
  6. Click Save when done.

Custom Roles in a project

You can create a new Role with a custom set of permission and assign it to project participants by adding them to the Role.

To create a custom Role

  1. Navigate to the project.

  2. On the project sidebar menu, choose Settings.

  3. On the Project Settings page, go to the Access tab.

    The Access page will be displayed.

  4. Click New Role:

    projectAddPermissionGroup.png
  5. The new Role will be listed on the left pane under Custom Roles:

    projectCustomRole.png
  6. Optionally, edit the new role's name. Instead of a general "custom role" you can give it a more descriptive name depending on the permission set you're going to grant it, e.g. "Privileged Member".

  7. Click Edit permissions and select the permissions that you want included in this Role:

    projectCustomRolePermissions.png
  8. Click Save when done.

To assign a custom Role to people (Add people to custom Role)

  1. Navigate to the project.

  2. On the project sidebar menu, choose Settings.

  3. On the Project Settings page, go to the Access tab.

    The Access page will be displayed.

  4. Select the custom Role you want to assign.

  5. Under Role members, add people or teams by selecting them from the drop-down list:

    projectAddMemberToCustomRole.png

Guests in a project

Users registered in the organization as Guests can be added to your project, but you cannot assign them (add them to) another role nor modify the Guest role.

The default access gives Guest users only viewing rights within the project. If you want a Guest user to collaborate on the project (e.g. commit to a repository, edit documents, etc.), you can provide them with extra rights. Additional permissions can be granted to individual Guest users on one-by-one basis.

Add a guest to the project

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Go to the Guests tab.

  4. Click Add guests from other projects and start typing the name into the text field or choose it from the drop-down list:

    addGuestToProject.png

Edit permissions for a guest

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Go to the Guests tab.

    All the project's guests are listed here.

  4. Locate the Guest user which permissions you want to edit (grant or revoke) and click edit.png next to that user.

    editGuestProjectPermissions.png
  5. Add or remove permissions using the checkboxes.

    guestProjectPermissions.png
  6. Click Save when done.

Default project roles comparison

Permission\Role

Project Admin

Project Member

Project Collaborator

Organization Member

Automation Service

Project (General)

View project details

check.png

check.png

check.png

check.png

check.png

Manage project permission scheme

check.png

Project Checklists

Manage checklists (Create and edit project checklists)

check.png

check.png

check.png

Project Issues

View issues

check.png

check.png

check.png

check.png

Manage issue settings

check.png

Update issues

check.png

check.png

check.png

Import issues

check.png

Restore issues

check.png

Create issues

check.png

check.png

check.png

Move issues

check.png

check.png

check.png

Manage tags

check.png

check.png

check.png

View spent time

check.png

check.png

Manage own spent time

check.png

check.png

check.png

Manage any spent time

check.png

Issue Comments

Post comments to issues

check.png

check.png

check.png

check.png

Add reactions to issue comments

check.png

check.png

check.png

check.png

View reactions to issue comments

check.png

check.png

check.png

check.png

Pin or unpin issue comments

check.png

check.png

check.png

check.png

View participants in issue comment threads

check.png

check.png

check.png

check.png

Add participants to issue comment threads

check.png

check.png

check.png

check.png

Project Boards

Create boards

check.png

Manage boards

check.png

Manage issue assignment

check.png

check.png

check.png

View boards

check.png

check.png

check.png

check.png

Project Responsibilities

View responsibilities

check.png

Update responsibilities (Assign responsibilities to project members)

check.png

Git Repositories

Read Git repositories (View repositories source)

check.png

check.png

check.png

check.png

check.png

Write Git repositories (Commit to repositories)

check.png

check.png

check.png

Manage Git repositories (Edit repository configuration)

check.png

Report external status checks (For external service authorized by a member with this permission)

Package Repositories

Create package repositories (Create new package repository)

check.png

check.png

check.png

Read package repositories (View repositories source)

check.png

check.png

check.png

check.png

check.png

Write package repositories (Commit to repositories)

check.png

check.png

check.png

check.png

Admin package repositories (Edit repository configuration)

check.png

Code Review

View code reviews

check.png

check.png

check.png

check.png

check.png

Create code reviews

check.png

check.png

check.png

Edit code reviews

check.png

check.png

check.png

Create suggested edit

check.png

check.png

check.png

Moderate suggestions

check.png

check.png

check.png

Code Review Comments

View code review comments

check.png

check.png

check.png

check.png

Post comments to code reviews

check.png

check.png

check.png

check.png

View code review channel participants

check.png

check.png

check.png

check.png

Add reactions to comments in code reviews

check.png

check.png

check.png

check.png

View reactions to comments in code reviews

check.png

check.png

check.png

check.png

Add participants to code review discussions and threads

check.png

check.png

check.png

check.png

Project Documents

Create folders

check.png

Create documents

check.png

check.png

check.png

View folder metadata

check.png

Post content for other members

View documents

check.png

Edit documents

check.png

Manage documents (move, rename)

check.png

Archive documents

check.png

Delete documents forever

check.png

Vault Connections

View Vault connections

check.png

check.png

check.png

check.png

Modify Vault connections

check.png

check.png

check.png

Delete Vault connections

check.png

check.png

check.png

Project Deployments

View deployments

check.png

check.png

check.png

check.png

check.png

Modify deployment targets

check.png

check.png

Modify deployments

check.png

check.png

Automation (Jobs)

View automation jobs

check.png

check.png

check.png

check.png

check.png

Start automation jobs

check.png

check.png

check.png

Stop automation jobs

check.png

check.png

check.png

Manage automation jobs

check.png

Project Parameters

View project parameters

check.png

check.png

check.png

check.png

Modify project parameters

check.png

check.png

check.png

Delete project parameters

check.png

check.png

check.png

Project Secrets

View keys of project secrets

check.png

check.png

check.png

check.png

Create project secrets

check.png

check.png

check.png

Delete project secrets

check.png

check.png

check.png

Update project secrets

check.png

check.png

check.png

Use project secrets

check.png

Dev environments

Create dev environments

check.png

check.png

View dev environments of all project members

check.png

Manage dev environments of all project members

check.png

Manage all dev environments

Last modified: 03 February 2023