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 teams'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 whithin 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 permssions 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:

    chooseProjectSettingsPermissions.png

    The Access page will be displayed.

  4. On the left pane, choose the Role that you want to edit. On the right pane, open the Permissions tab:

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

    editProjectPermissions.png

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:

    chooseProjectSettingsPermissions.png

    The Access page will be displayed.

  4. Click New Role:

    projectAddPermissionGroup.png
  5. Give this new Role a name.

  6. Using the checkboxes, select the permissions that you want this Role to have.

    projectConfigurePermissionGroup.png
  7. Your settings will be saved automatically.

Default project roles comparison

Permission\Role Project Admin Project Member Project Collaborator Organization Member Automation Service
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 statuses check.png
Edit issues check.png check.png check.png
Project Responsibilities
View responsibilities check.png check.png check.png check.png
Edit responsibilities (Assign responsibilities to project members) check.png
Git Repositories
Repository access - Read (View repositories source) check.png check.png check.png check.png check.png
Repository access - Write (Commit to repositories) check.png check.png check.png
Repository access - Admin (Edit repository configuration) check.png
Report external check status (For external service authorized by a member with this permission)
Package Repositories
Repository access - Read (View repositories source) check.png check.png check.png check.png check.png
Repository access - Create (Create new package repository) check.png check.png check.png
Repository access - Write (Commit to repositories) check.png check.png check.png check.png
Repository access - Admin (Edit repository configuration) check.png
Books (Project Documents)
Create and attach books check.png
View book metadata check.png check.png check.png check.png
Post content for other members
View content check.png check.png check.png check.png
Edit content check.png check.png check.png
Manage books (Create, move, rename, delete) check.png
Automation (Jobs)
View check.png check.png check.png check.png
Start check.png check.png check.png
Stop check.png check.png check.png
Admin (Edit jobs) check.png
Project Parameters
View parameters check.png check.png check.png check.png check.png
Modify parameters check.png check.png check.png
Delete parameters check.png check.png check.png
Project Secrets
View keys of secrets check.png check.png check.png check.png check.png
Create secrets check.png check.png check.png
Delete secrets check.png check.png check.png
Edit secrets check.png check.png check.png
Use secrets check.png check.png
Last modified: 15 December 2020