Rename or remove a team
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
As your organization changes, you might need to rename or remove a team.
When you rename a team, the new name propagates throughout Azure DevOps. The following team artifacts are automatically renamed:
- Team security group
- Team backlogs and boards
- Team dashboards
Tip
Update any queries that reference the old team security group name.
When you remove or delete a team, all of its configuration settings get deleted. These settings include team dashboards, backlogs, and boards. Data defined for work items that are assigned to the team are left unchanged. Once deleted, you can't recover the team configurations.
Prerequisites
Permissions:
- Team Administrator or Project Administrators group: To rename a team, you must be a team administrator or a member of the Project Administrators group.
- Project Administrators group: To remove or delete a team, you must be a member of the Project Administrators group.
Rename a team
Note
To enable the user interface for the New Teams Page, see Manage or enable features.
From your project in the web portal, select Project settings > Teams.
Choose the team you want to rename, and then select Settings.
Under Team Details, enter a new name for the team. Optionally, add a new description.
Save your changes.
The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.
Set a team as the default
When a project gets created, a default team also gets created based on the project name.
- Open Project settings > Teams.
- Select More options next to the team you want as the new default, and then select Set team as project default.
Delete a team
You can delete any team except the default team. At least one team must be defined for a project.
Important
Deleting a team removes all team configuration settings (dashboards, backlogs, boards). Work item data remains unchanged. Team configurations cannot be recovered once deleted.
Note
To enable the user interface for the New Teams Page, see Manage or enable features.
From your project in the web portal, select Project settings > Teams as shown in the previous section.
Select the team you want to delete and then select Settings.
Scroll down and select Delete Team.
Select Delete in the confirmation box to complete the delete operation.
The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.