Rename or remove a team
Azure DevOps Server 2019
As your organization evolves, you might need to rename or remove a team to better align with new roles, projects, or organizational structures.
When you rename a team, the new name automatically propagates throughout Azure DevOps, ensuring consistency and avoiding confusion. The following team artifacts automatically get renamed:
- Team security group
- Team backlogs and boards
- Team dashboards
Automatic renaming maintains access controls, project tracking, and dashboard configurations without manual updates. Removing a team deletes its configurations and reassigns its members to other teams, ensuring workflow continuity and organizational clarity.
Tip
Update any queries that reference the old team security group name.
Deleting a team removes all configuration settings, including dashboards, backlogs, and boards. Work item data remains unchanged. Team configurations cannot be recovered after deletion.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Member of the Project Administrators security group. |
Rename a team
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.
The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.
