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

# Team Management

> Invite users, assign roles, and manage team access

## Overview

Manage your team members, assign roles, and control access to Stacks and resources in StatusStack.

***

## User Roles

### Organization-Level Roles

| Role       | Permissions                        | Use Case             |
| ---------- | ---------------------------------- | -------------------- |
| **Owner**  | Full access including billing      | Company owner        |
| **Admin**  | Manage teams, users, all resources | IT director          |
| **Member** | Access assigned teams only         | Engineers, operators |

### Team-Level Roles

| Role            | Permissions             | Use Case              |
| --------------- | ----------------------- | --------------------- |
| **Team Admin**  | Full team access        | Team lead             |
| **Team Member** | Create/edit within team | Engineers             |
| **Team Viewer** | Read-only               | Stakeholders, clients |

***

## Inviting Team Members

<Steps>
  <Step title="Navigate to Team Settings">
    Dashboard → **Settings** → **Teams** → Select team
  </Step>

  <Step title="Click Invite Member">
    Click **"Invite Member"** button
  </Step>

  <Step title="Enter Details">
    ```yaml theme={null}
    Email: user@company.com
    Role: Member (or Admin/Viewer)
    Teams: Select which teams to add them to
    ```
  </Step>

  <Step title="Send Invitation">
    Email invitation sent

    Valid for 7 days
  </Step>

  <Step title="User Accepts">
    User clicks link and creates account

    Automatically added to team
  </Step>
</Steps>

***

## Managing Team Members

### Changing Roles

1. Go to team settings
2. Find user in members list
3. Click role dropdown
4. Select new role
5. Save changes

### Removing Members

1. Go to team settings
2. Find user
3. Click **"Remove"**
4. Confirm removal

**Note:** User loses access to team resources immediately

### Transferring Ownership

Organization Owner only:

1. **Settings** → **Organization**
2. Click **"Transfer Ownership"**
3. Select new owner
4. Confirm transfer
5. You become Admin

***

## Best Practices

<AccordionGroup>
  <Accordion title="Principle of Least Privilege">
    Start with minimal access:

    * New users: Viewer initially
    * Promote to Member after training
    * Admin role for trusted users only
    * Owner limited to 1-2 people
  </Accordion>

  <Accordion title="Regular Access Reviews">
    Quarterly review:

    * [ ] Review active users
    * [ ] Remove former employees
    * [ ] Verify roles appropriate
    * [ ] Update team memberships
  </Accordion>

  <Accordion title="Use Teams for Organization">
    Structure teams by:

    * Department (Engineering, Ops)
    * Environment (Production, Staging)
    * Client (for MSPs)
    * Project
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Teams & Organizations" icon="building" href="/concepts/teams-organizations">
    Understanding team structure
  </Card>

  <Card title="Security Settings" icon="shield" href="/account/security">
    Configure security
  </Card>
</CardGroup>