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

# Team roles

> Give teams control over their own escalation paths, schedules, and alert configuration

[Team roles](https://app.incident.io/~/settings/permissions/team) allow you to give teams the ability to manage their own config (escalation paths, schedules, alert routes, alert sources, and [API keys](/admin/api-keys)) without letting them make changes to a different team's config. Each resource can be owned by different teams - for example, one alert route could be managed by Team A while another alert route is managed by Team B.

<Frame caption="Creating a team role">
  <img
    src="https://mintcdn.com/incidentio-18bb4170/RywJbdur7X45Tv2e/images/help-centre/team-roles/screenshot-1.png?fit=max&auto=format&n=RywJbdur7X45Tv2e&q=85&s=69a0acffbd8c3b67382f92a1ad4c3a4c"
    alt="Creating a team role with Admins attribute and schedule permissions
selected"
    width="1024"
    height="1682"
    data-path="images/help-centre/team-roles/screenshot-1.png"
  />
</Frame>

Team roles have a configurable set of permissions assigned to them, and you can configure multiple team roles (for example Members and Admins) so that you can give certain people on the team additional roles that you don't give to all team members.

**Team roles are in addition to** [account-level roles](/admin/user-permissions) **, so if someone has permission to manage something at the account level, they'll be able to make changes even if they're not on the team that owns it**.

Who has which team role is controlled via the catalog. Each team role corresponds to an attribute on your Team catalog type (you can [configure which catalog type represents your teams here](https://app.incident.io/~/settings/teams) ).

Users can have multiple roles on a team, and if they do, they have the union of permissions across all their roles.

<Info>
  If your teams are controlled externally (for example via Linear, GitHub, the catalog importer, Terraform), then anyone who has permission to update teams in the external system will be able to control which users have team roles within incident.io
</Info>

## Example: Team-owned schedules

This example shows the steps needed to make it so that everyone on a team can set up schedule overrides but only the manager of the team can edit the schedule.

First, make sure that schedules are owned by the correct team:

<Frame caption="Configuring which team owns a schedule">
  <img src="https://mintcdn.com/incidentio-18bb4170/RywJbdur7X45Tv2e/images/help-centre/team-roles/screenshot-2.png?fit=max&auto=format&n=RywJbdur7X45Tv2e&q=85&s=09071f27dcf2aa8ee015970df4a0661a" alt="Editing a schedule with the Infra team selected as owner" width="1230" height="732" data-path="images/help-centre/team-roles/screenshot-2.png" />
</Frame>

Next, [create new team roles](https://app.incident.io/~/settings/permissions/team/create) for members and admins:

<Frame caption="Viewing team roles">
  <img
    src="https://mintcdn.com/incidentio-18bb4170/RywJbdur7X45Tv2e/images/help-centre/team-roles/screenshot-3.png?fit=max&auto=format&n=RywJbdur7X45Tv2e&q=85&s=c85b5a065e528c189657b54df14e356e"
    alt="Team roles list showing Admin and Member roles with their
permissions"
    width="1610"
    height="686"
    data-path="images/help-centre/team-roles/screenshot-3.png"
  />
</Frame>

Lastly, you can view and control who has what roles on the Members tab of the team's page:

<Frame caption="Viewing a team's members and their roles">
  <img src="https://mintcdn.com/incidentio-18bb4170/RywJbdur7X45Tv2e/images/help-centre/team-roles/screenshot-4.png?fit=max&auto=format&n=RywJbdur7X45Tv2e&q=85&s=397b04542ffd77f0e0a3f43f79a5502f" alt="Team members list showing each member's roles" width="1762" height="846" data-path="images/help-centre/team-roles/screenshot-4.png" />
</Frame>

<Frame caption="Editing a team member's roles">
  <img src="https://mintcdn.com/incidentio-18bb4170/RywJbdur7X45Tv2e/images/help-centre/team-roles/screenshot-5.png?fit=max&auto=format&n=RywJbdur7X45Tv2e&q=85&s=e266c48d9e6faf74623fe7d0b93e0d47" alt="Editing a team member's roles with Admin and Member options" width="1770" height="1150" data-path="images/help-centre/team-roles/screenshot-5.png" />
</Frame>

Now all members of teams will be able to create overrides for schedules they're on, but only admins of those teams will be able to make changes to the schedule (for example working hours, when shift handovers happen, etc).
