Teams

Create Teams to customize information presented to specific users

Teams allow users to group and control user access to associated PagerDuty objects, such as escalation policies, users, schedules and services. They also allow users to customize the PagerDuty web app by filtering for information relevant to their Team’s associated objects. For example, a Security Team member may only want to see the users, incidents, schedules and services associated with the Security Team's escalation policies.

📘

Pricing Plan

Teams are available on Business and Digital Operations plans. Please contact our Sales Team if you would like to upgrade to a plan featuring Teams.

Team Association Behavior

With Advanced Permissions, PagerDuty objects such as users, schedules, services and escalation policies may be grouped by their Team associations. When an escalation policy is added to a Team, the users, schedules and services associated with that escalation policy are also added to that Team. Furthermore, if any such objects have a Team association, then PagerDuty users will derive their permissions for those related objects through their Team role. So, for example, a user who has a Responder role on a Team will also become a Responder on the Team's associated escalation policies, schedules and services.

In order for this behavior to apply the correct permissions and not create any unwanted side effects, there are a few implicit changes that may occur when modifying PagerDuty objects:

  • Users added to an escalation policy or schedule will be automatically added to those objects’ associated Teams.
  • Schedules Update or Create API: Adding users to a schedule via API will add the users to any associated Teams.
  • Schedules Update or Create API: Associating a Team with a schedule via API will add the schedule’s users to the Team.
  • Escalation Policy Update or Create API: Adding a user to an escalation policy will add the user to any associated Teams. Such members may not be removed from the Team if they are still associated with an escalation policy that the Team is associated with.

Create a Team

🚧

Required User Permissions

Manager, Global Admin or Account Owner roles can create Teams.

📘

Note

  • You can add up to 100 unique escalation policies per team.
  • There is a limit of 500 users per Team.
  • Users can be on multiple Teams, but escalation policies can only be associated with one Team.

We recommend that you create schedules and escalation policies before creating a Team. When you add an escalation policy to a Team, the escalation policy's users and schedules will be automatically assigned to your Team. Please read Team Association Behavior (above) for more information.

  1. Go to People Teams and click New Team.
  2. Enter a Name for the Team and optionally add Tags. Click Save to continue.
  3. You will then be directed to the Team’s details page. Click Edit Team on the right.
  4. Search and select the Escalation Policies or Users that you would like to add to this Team.
    • Note: When you add an escalation policy to a Team, the users, schedules and services associated with it will be automatically added to the Team. You may also optionally select individual Users to associate with the Team if they are not on the escalation policies you selected.
  5. Click Save.

Edit or Delete Teams

🚧

Required User Permissions

Manager, Global Admin or Account Owner roles can edit or delete Teams.

  1. Navigate to People Teams and click the to the right of the Team name.
  • If you are editing a Team: Select Edit from the dropdown. You may edit the Name by entering a new name. You may also edit Escalation Policies, Users and Tags by searching and selecting them from their fields. To remove escalation policies, users or tags, click the x to the left of the object. When you are finished editing, click Save.
  • If you are deleting a Team: Select Delete from the dropdown. A dialog will appear that will prompt you to Edit Rulesets, Escalation Policies, Services and Schedules and Reassign Incidents associated with the Team, with the option to reassign incidents to another team via the dropdown. Once you have performed these tasks, click Delete Team.

Edit Team Roles

Please read our Advanced Permissions article for more information.

Manage Team Business Service Subscriptions

Please see our section on Subscribing Teams to Business Services.

Manage Primary Team

🚧

Required User Permissions

Global Admin or Account Owner roles can manage Primary Teams.

📘

Note

A user must already be a Team member of the selected primary Team. You may add users to a new Team or add a user to an existing team through the Teams page to select a primary Team that the user is not already on.

Some organizations may want users to have primary teams for billing purposes. To designate a user's primary team:

  1. Navigate to People, select Users and click the name of the desired user.
  2. Select the Permissions & Teams tab and click the Manage primary team button in the Teams & Team Roles section.
  3. On the next screen you will have the option to search and select the user's desired primary team, or you may remove one by clicking the Unset primary team button. Click Confirm Selection to save.
  1. You will now be able to see the user's primary team in the Teams & Team Roles section.

Filter by Team

The Team filter dropdown is available on most PagerDuty objects in the web app, such as the Incidents page, Service Directory, Users, Escalation Policies, Reports, etc.

  • To filter the UI by Team in PagerDuty, click the Team drop-down. You can choose to view All Teams, My Teams, or select specific Team(s).
  • When you select a Team filter on one page, the filter will persist as you navigate to other pages. For example, to quickly see all users in a Team, go to the Team drop-down menu and select the your preferred Team, and then go to People Users. You will see that only users associated with the selected Team will appear.
  • Your filter selection will not impact the view that other users see in their account.

Team Privacy

Please read our Advanced Permissions article for more information.

Responding to Incidents From Other Teams

Please read our Advanced Permissions article for more information.


Did this page help you?