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 person to the project and assigning them 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.

  • External Collaborators — defines a limited set of permissions that can be enabled for users registered in the organization as Collaborators and added to the project. Permissions from this set can be enabled for each External Collaborator individually and will be only valid within this project.

  • Guests — defines a limited set of permissions that can be enabled for users registered in the organization as Guests and added to the project. Permissions from this set can be enabled for each Guest individually and will be only valid within this project.

  • 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.

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

Add people to the project

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Click Add participants and choose a person or team from the drop-down list:

    addParticipantToProject.png
  4. Choose what role the participant should have in the project:

    chooseParticipantsRole.png

    You can't choose a different role for an External user (Collaborator or Guest), but you can grant such users additional project permissions on an individual basis.

  5. When you're done adding participants, click Save.

    All project participants are listed on the page. The filters above the list show the roles used in the projects and the number of participants in each role:

    participantsListed.png

    Click on a filter to see only participants with the respective role. Click again to disable the filter and see the full list.

Revoke project access rights

You can revoke access permissions provided by any role by removing a participant from the list on the People page.

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Find a person or team you want to remove using the Search by name field, or click on a corresponding role on top of the list to filter it.

  4. Delete a participant from the list:

    revokeProjectMembership.png

Configure project permissions

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. Enable or disable permissions for the selected Role. Make sure you scroll down the list to view all available permissions:

    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 generic "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. Make sure you scroll down the list to view all available permissions::

    projectCustomRolePermissions.png
  8. Click Save when done.

To assign a custom Role to participants

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. To assign the custom role to a new participant, first add the participant to the project.

    Locate the participant on the list then choose the custom role from the drop-down menu:

    projectAddMemberToCustomRole.png

External users in a project

External user is a person who registered in your Space organization either as Guest or Collaborator. External users are not considered organization members and therefore have limited access rights. To allow External users to participate in your project, you should add them to the project and explicitly grant them permissions you consider necessary.

The default access only gives External users (both Collaborators and Guests) basic viewing rights within the project. If you want an External user to collaborate on the project and have access to certain project resources, you can provide them with extra permissions. You cannot assign them (add them to) another role nor modify the Collaborator or Guest roles. Additional permissions can be granted to individual External users on one-by-one basis. Keep in mind that Collaborators can be granted a much wider scope of permissions than Guests. While a Collaborator can be provided access to all non-administrative project features and functionality, the permissions available to a Guest are limited to Documents, Issues, and Issue boards.

Add an External user to the project

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

  3. Click Add participants and choose the person you want to add from the drop-down list:

    addExternalUserToProject.png
  4. Click Save.

    The external user will be added to your project and granted the default permissions. You can grant that user additional permissions from the selection limited by the user's role (Collaborator or Guest).

Edit permissions for an External user

  1. Navigate to the project.

  2. On the project sidebar menu, choose People.

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

    editExternalUserProjectPermissions.png
  4. Scroll down the list to see all permissions. Add or remove permissions using checkboxes.

    externalUserProjectPermissions.png
  5. Click Save when done.

Default project roles comparison

The table below lists the default permissions for each Role.

check.png — available and enabled by default

check-empty.png — available but disabled by default

No checkbox — not available and cannot be enabled

Project (General)

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View project details

check.png

check.png

check.png

check-empty.png

check-empty.png

check.png

Manage project permission scheme

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Manage project sidebar pins

check.png

check.png

check-empty.png

check-empty.png

Git Repositories

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

Read Git repositories (View repositories source)

check.png

check.png

check.png

check-empty.png

check.png

Write Git repositories (Commit to repositories)

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Manage Git repositories (Edit repository configuration)

check.png

check-empty.png

check-empty.png

check-empty.png

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

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Project Responsibilities

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View responsibilities

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Update responsibilities (Assign responsibilities to project members)

check.png

check-empty.png

check-empty.png

check-empty.png

Automation (Jobs)

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View automation jobs

check.png

check.png

check.png

check-empty.png

check.png

Start automation jobs

check.png

check.png

check-empty.png

check-empty.png

Stop automation jobs

check.png

check.png

check-empty.png

check-empty.png

Manage automation jobs

check.png

check-empty.png

check-empty.png

check-empty.png

Project Secrets

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View keys of project secrets

check.png

check.png

check.png

Create project secrets

check.png

check.png

check-empty.png

check-empty.png

Delete project secrets

check.png

check.png

check-empty.png

check-empty.png

Update project secrets

check.png

check.png

check-empty.png

check-empty.png

Use project secrets

check-empty.png

check-empty.png

check-empty.png

check.png

Project Parameters

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View project parameters

check.png

check.png

check.png

Modify project parameters

check.png

check.png

check-empty.png

check-empty.png

Delete project parameters

check.png

check.png

check-empty.png

check-empty.png

Code Review

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View code reviews

check.png

check.png

check.png

check-empty.png

check.png

Create code reviews

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Edit code reviews

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Create suggested edit

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Moderate suggestions

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Code Review Comments

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View code review comments

check.png

check.png

check.png

check-empty.png

check-empty.png

Post comments to code reviews

check.png

check.png

check.png

check-empty.png

check-empty.png

View code review channel participants

check.png

check.png

check.png

check-empty.png

Add reactions to comments in code reviews

check.png

check.png

check.png

check-empty.png

check-empty.png

View reactions to comments in code reviews

check.png

check.png

check.png

check-empty.png

check-empty.png

Add participants to code review discussions and threads

check.png

check.png

check.png

check-empty.png

Project Issues

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View issues

check.png

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Manage issue settings

check.png

check-empty.png

check-empty.png

check-empty.png

Update issues

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Import issues

check.png

check-empty.png

check-empty.png

check-empty.png

Restore issues

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Create issues

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Move issues

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Manage tags

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

View spent time

check.png

check-empty.png

check-empty.png

check-empty.png

Manage own spent time

check.png

check.png

check-empty.png

check-empty.png

Manage any spent time

check.png

check-empty.png

check-empty.png

check-empty.png

Issue Comments

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

Post comments to issues

check.png

check.png

check.png

check-empty.png

check-empty.png

Add reactions to issue comments

check.png

check.png

check.png

check-empty.png

check-empty.png

View reactions to issue comments

check.png

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Pin or unpin issue comments

check.png

check.png

check.png

check-empty.png

check-empty.png

View participants in issue comment threads

check.png

check.png

check.png

check-empty.png

check-empty.png

Add participants to issue comment threads

check.png

check.png

check.png

check-empty.png

check-empty.png

Project Boards

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

Create boards

check.png

check-empty.png

check-empty.png

check-empty.png

Manage boards

check.png

check-empty.png

check-empty.png

check-empty.png

Manage issue assignment

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

View boards

check.png

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

Package Repositories

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

Create package repositories (Create new package repository)

check.png

check.png

check-empty.png

check-empty.png

Read package repositories (View repositories source)

check.png

check.png

check.png

check-empty.png

check.png

Write package repositories (Commit to repositories)

check.png

check.png

check-empty.png

check.png

Admin package repositories (Edit repository configuration)

check.png

check-empty.png

check-empty.png

check-empty.png

Project Documents

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

Create folders

check.png

check-empty.png

check-empty.png

check-empty.png

Create documents

check.png

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

View folder metadata

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

View documents

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Edit documents

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Manage documents (move, rename)

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Archive documents

check.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

check-empty.png

Delete documents forever

check.png

check-empty.png

check-empty.png

check-empty.png

Vault Connections

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View Vault connections

check.png

check.png

check.png

Modify Vault connections

check.png

check.png

check-empty.png

check-empty.png

Delete Vault connections

check.png

check.png

check-empty.png

check-empty.png

Project Deployments

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

View deployments

check.png

check.png

check.png

check-empty.png

check.png

Modify deployment targets

check.png

check-empty.png

check-empty.png

check.png

Modify deployments

check.png

check-empty.png

check-empty.png

check.png

Dev environments

Permission\Role

Project Admin

Project Member

Organization Member

Collaborator (External)

Guest (External)

Automation Service

Create dev environments

check.png

check.png

check-empty.png

check-empty.png

View dev environments of all project members

check.png

check-empty.png

check-empty.png

check-empty.png

Manage dev environments of all project members

check.png

check-empty.png

check-empty.png

check-empty.png

Join dev environments from hot pool

check.png

check.png

check-empty.png

check-empty.png

Manage warm-up automatic triggers

check.png

check-empty.png

check-empty.png

check-empty.png

Last modified: 04 October 2023