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

# Teams

> Browse, create, edit, and archive organizational teams, with search filtering and active/inactive status management.

The Teams page lists all organizational teams and provides create/edit/archive dialogs. It is served at route `/hr/teams`.

## Overview

The page uses `useTeamList` to fetch teams and `useTeamMutation` (createTeam, updateTeam) for write operations. A search input filters teams by name. Clicking a team card opens an edit dialog; clicking the archive icon opens an archive confirmation dialog. Team cards display name, description, active status, and team lead.

Permission: `HR_PERMISSIONS.TEAMS_VIEW` (`hr.teams.view`) — `RequirePermission` guard in `hr.tsx`.

## Who it's for

Permission: `hr.teams.view` — required by `RequirePermission` guard in `hr.tsx`.

## Before you start

* None required; the page loads existing teams on first visit.

## Steps

**View and search teams**

1. Navigate to **HR > Teams** or go to `/hr/teams`.
2. Use the **Search** input to filter teams by name.

**Create a team**

1. Click **New Team** (or equivalent action button).
2. Enter team name, optional description, team lead, and active status.
3. Save to create the team.

**Edit a team**

1. Click a team card to open the edit dialog.
2. Modify fields and save.

**Archive a team**

1. Click the archive icon on a team card.
2. Confirm the archive action in the confirmation dialog.

## Key concepts

| Term              | Meaning                                                              |
| ----------------- | -------------------------------------------------------------------- |
| Team lead         | Employee designated as the lead for the team (optional).             |
| Active / Inactive | Teams can be deactivated without deletion.                           |
| Archive           | Marks a team as inactive. SME: confirm whether this removes members. |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr.tsx
  * src/cores/hr/pages/Teams.tsx
  * src/cores/hr/hooks/employees/useTeamList.ts
  * src/cores/hr/hooks/employees/useTeamMutation.ts
</Accordion>