---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/teams.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/teams.md
  - href: en/sourcecraft/operations/teams.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt

<!-- source: en/_includes/sourcecraft/security-teams.md -->
# Teams in SourceCraft

_Teams_ is a tool for access management and collaboration within an [organization](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#org).

You can form teams of users in your organization to assign [roles](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md#roles-list) collectively. This is a useful feature for any organization with a large membership, unhappy about assigning roles individually to each member.

{% note warning %}

Teams can be managed only by users with the `Organization admin` [role](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md#organization-manager-admin).

{% endnote %}

Teams support only a single-level structure. You cannot create a team within a team. Team membership gives equal permissions to all members.

SourceCraft teams correspond to [user groups](https://yandex.cloud/en/docs/organization/concepts/groups) in Yandex Identity Hub.

{% note tip %}

If you use user groups in your identity provider (IdP) when working with [federations](https://yandex.cloud/en/docs/organization/concepts/add-federation), you can [map groups](https://yandex.cloud/en/docs/organization/concepts/add-federation#group-mapping) between the IdP and Yandex Identity Hub.

{% endnote %}

## Creating a team {#create-team}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, navigate to ![image](../../_assets/console-icons/briefcase.svg) **Organizations**.
1. Select the organization you want to create a team in.
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. In the top-right corner, click **New team**.
1. Enter a name and (optionally) a description for the team.
1. Click **Create team**.

## Adding team members {#add-team-members}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. Select the team you want to add members to.
1. In the top-right corner, click **New member**.
1. In the window that opens, start typing the user's public name in the drop-down list, e.g., `John Smith`, or nickname, e.g., `jsmith-2000`, and select the user from among the suggested options. Select all users you want to add to the team one by one.
1. Click **Add members**.

## Removing a team member {#remove-team-members}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. Select a team.
1. Next to the member you want to remove, click ![image](../../_assets/console-icons/ellipsis.svg), select ![image](../../_assets/console-icons/trash-bin.svg) **Remove member** and confirm the removal.

## Assigning roles to team members {#add-team-roles}

You can assign roles to team members [for all repositories in your organization](#add-team-roles-repo) or [for a specific repository](#add-team-roles-org).

### Assigning roles in an organization {#add-team-roles-org}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. Next to the team whose members you want to assign [roles](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md#roles-list) to, click ![image](../../_assets/console-icons/sliders.svg) in the **Members & roles** column.
1. Mark the ![image](../../_assets/console-icons/check.svg) roles you want to assign to the team members.
1. Click **Apply**.

### Assigning a role in a repository {#add-team-roles-repo}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**.
1. Select the repository in which you want to assign a role to a team.
1. Under ![image](../../_assets/console-icons/gear.svg) **Repository settings** on the repository page, go to ![image](../../_assets/console-icons/persons-lock.svg) **Members & roles**.
1. In the top-right corner, click **New role**.
1. In the window that opens:
    * From the **Role** drop-down list, select the [role](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md#src-roles) you want to assign to a team.
    * Select a team from the **Subject** drop-down list.
1. Click **Add**.

## Revoking roles from team members {#remove-team-roles}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. Next to the team members whose [roles](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md#roles-list) you want to revoke, click ![image](../../_assets/console-icons/sliders.svg) in the **Members & roles** column.
1. Uncheck ![image](../../_assets/console-icons/check.svg) the boxes next to the roles you want to revoke from team members.

## Changing team settings {#change-team-settings}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. Next to the team whose settings you want to change, click ![image](../../_assets/console-icons/ellipsis.svg) and select ![image](../../_assets/console-icons/gear.svg) **Teams settings**.
1. Change the team settings and click **Update settings**.

## Deleting a team {#delete-team}

{% note alert %}

Deleting a team will revoke the roles of all its members granted as part of the team.

{% endnote %}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Under ![image](../../_assets/console-icons/person-nut-hex.svg) **People**, navigate to ![image](../../_assets/console-icons/persons.svg) **Teams**.
1. Next to the member you want to delete, click ![image](../../_assets/console-icons/ellipsis.svg), select ![image](../../_assets/console-icons/trash-bin.svg) **Delete team** and confirm the deletion.
<!-- endsource: en/_includes/sourcecraft/security-teams.md -->

#### Useful links {#see-also}

* [Access management in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/security/index.md)
* [Sending and accepting an invitation to a SourceCraft organization](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/invite.md)
* [Assigning a role to a user in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/bind.md)