> ## Documentation Index
> Fetch the complete documentation index at: https://support.calderapbc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> Group members into teams that hold roles, so everyone on the team inherits the same permissions.

Teams let **Owners** grant the same roles to a group of members at once. Instead of assigning roles to each person individually, you create a team, give it the roles you want, and add members to it. Every member inherits the permissions of every team they belong to, on top of any roles assigned to them directly.

<Warning>
  Only users with the **Owner** role can create and manage teams. Teams live on the Organization page alongside Members.
</Warning>

## Open the Teams page

Click your organization name in the top-left corner, select **Organization**, then choose **Teams** from the sidebar.

<Frame>
  <img src="https://mintcdn.com/calderapbc/S3rPQKV8Oettlbz6/images/teams-list.png?fit=max&auto=format&n=S3rPQKV8Oettlbz6&q=85&s=a8b1e19386af7bb1dd6ffd15afbce3a0" alt="The Teams page listing each team with its roles and member count" width="2494" height="1770" data-path="images/teams-list.png" />
</Frame>

The Teams table shows each team's name, the roles it grants, and how many members belong to it. Click any team to open its detail page.

## Create a team

<Steps>
  <Step title="Start a new team">
    Click **New Team** in the top-right of the Teams page.

    <Frame>
      <img src="https://mintcdn.com/calderapbc/S3rPQKV8Oettlbz6/images/teams-new-button.png?fit=max&auto=format&n=S3rPQKV8Oettlbz6&q=85&s=64627a0772cdb91635017d5c44f1f25d" alt="The New Team button on the Teams page" width="2494" height="1770" data-path="images/teams-new-button.png" />
    </Frame>
  </Step>

  <Step title="Name the team and pick its roles">
    Give the team a name (for example, `Records Unit`), an optional description, and select the roles it should grant. Every member you add later inherits the permissions of these roles.

    <Frame>
      <img src="https://mintcdn.com/calderapbc/S3rPQKV8Oettlbz6/images/teams-new-form.png?fit=max&auto=format&n=S3rPQKV8Oettlbz6&q=85&s=38b8faa5c533e36c22d5e5b52235b22e" alt="The new team form with name, description, and role selector" width="2494" height="1770" data-path="images/teams-new-form.png" />
    </Frame>
  </Step>

  <Step title="Create">
    Click **Create**. Mesa opens the new team's detail page, where you can add members.
  </Step>
</Steps>

## Add and remove members

Open a team to manage who belongs to it.

* **Add a member**: click **Add Member**, then search for and select a member of your organization. They immediately inherit the team's roles.
* **Remove a member**: click **Remove** next to their name and confirm. They lose any permissions they held only through this team.

<Frame>
  <img src="https://mintcdn.com/calderapbc/S3rPQKV8Oettlbz6/images/teams-detail.png?fit=max&auto=format&n=S3rPQKV8Oettlbz6&q=85&s=5754e96b0d65fc142634ad8ef68b133b" alt="A team detail page showing its roles and member list" width="2494" height="1770" data-path="images/teams-detail.png" />
</Frame>

<Note>
  A member's effective permissions are the union of the roles assigned to them directly and the roles granted by every team they belong to. Removing a member from a team never revokes a role they also hold directly.
</Note>

## Edit or delete a team

From a team's detail page:

* **Edit** changes the team's name, description, or the roles it grants. Changing a team's roles updates the permissions of every member at once.
* **Delete** removes the team. Members lose any permissions they held only through it. This cannot be undone.

## Roles and permissions

Teams grant the same roles you can assign to a member directly. For what each role can do, see [Organization admin](/organization-admin).

## Related articles

<Card title="Organization admin" href="/organization-admin" horizontal>
  Assign roles to individual members and manage usage allocations.
</Card>

<Card title="Organization customization" href="/organization-customization" horizontal>
  Set shared skills, preferences, and pinned content for your team.
</Card>
