Delete a project in Azure DevOps

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

If you find that you have a project you no longer use, you can delete it. Deleting a project helps simplify the navigation to projects that are in use. You can delete a project from Azure DevOps Services or from an on-premises deployment of Team Foundation Server (TFS).

Note

Your web portal uses either the New navigation or Previous navigation user interface. Choose the New navigation tab if the New Navigation feature is enabled. You'll see a vertical sidebar along with other navigational features when New Navigation has been enabled for the signed-in user or the organization. Choose Previous navigation when you see a top-level, blue-bar—indicating that New navigation isn't enabled. For more information, see Web portal navigation.

Note

Choose the New navigation tab for guidance. Azure DevOps Server 2019 supports the New Navigation user interface. For more information, see Web portal navigation.

Note

Choose the Previous navigation tab for guidance. TFS 2018 and earlier versions only support the previous navigation user interface. For more information, see Web portal navigation.

Open Organization settings

Organization settings configure resources for all projects or the entire organization. For an overview of all organization settings, see Project collection administrator role and managing collections of projects.

  1. Choose the Azure DevOps logo to open Projects. Then choose Organization settings.

    Open Organization settings

  2. From there, you can choose a service from the sidebar. Settings are organized based on the service they support. Expand or collapse the major sections such as Work and CI/CD to choose a page.

    Organization settings, Projects

New navigation isn't supported on TFS at this time. Choose Previous navigation guidance.

Choose to delete a project

Caution

Deleting a project permanently removes data associated with that project from the database. You cannot recover it later. Therefore, you should save project data that you might want to access later.

  1. Open the actions icon menu for the project that you want to delete and choose Delete.

    Choose Delete menu option

    If you don't see the actions icon actions icon image, either you're not accessing Azure DevOps Services or you're not a member of the Project Collection Administrators group. Learn about joining the Project Collection Administrators group.

  2. You must type the name of the project in order to initiate the delete operation.

    delete-team-project-dialog

  1. From the Overview tab, open the context icon menu for the project that you want to delete and choose Delete.

    If you don't see the context icon menu, you don't have the permissions to delete the project. Learn about joining the Project Collection Administrators group.

  2. You must type the name of the project in order to initiate the delete operation.

    delete-team-project-dialog

Delete a project from the Team Foundation Server Administration console

Using the administration console, you can delete a project from a project collection. Afterwards, you'll need to manually delete any associated reports and SharePoint project portal. Or, you can use the TFSDeleteProject command line tool to delete all artifacts.

  1. If you're not a member of one or more of the following administrator groups, get those permissions now:

    • Team Foundation Administrators group (required).

    • SQL Server System Administrators group (required).

    • Farm Administrators group for SharePoint Products (required when your deployment uses SharePoint Products).

  2. Open the administration console for TFS and delete the project from its project collection.

    project collection delete button

  3. Choose whether to delete external data associated with the project and then initiate the delete action.

    delete projects dialog

  4. (Optional) To review the status of the delete action, open the Status tab.

    To review the details of the delete action, you can open the log file from either the Status tab or Logs tab.

Delete reports that remain after deleting a project

If your on-premises project used reporting, and you didn't choose to delete external artifacts, you can delete the reports using SQL Server Report Manager. From the project collection page, delete the folder that corresponds to the deleted project.

context menu with delete command

Remove the project portal

If your on-premises project had a project portal, all links to that portal will be removed from TWA and Team Explorer, but the SharePoint site or website that acted as the portal will not be deleted. If you want to delete the portal, you must do so manually after the project has been deleted. See How to: Create, Edit, and Delete Windows SharePoint Services Sites.

What to do if the delete action doesn't finish

Review the status and log files for the delete action. Open the Status tab and for Deleted, review the additional information in parentheses, and take the indicated action.

  • (Processing) means that the process has started and is in progress.

  • (Pending) means that the deletion process has started from a client application. The deletion might be in progress or might have failed. Because the process was started from a client application, the server cannot accurately report the status of the deletion.

    If a project deletion remains pending for a long time, try to delete the project again from the administration console.

  • (Failed) means that the deletion process started but did not successfully finish. The log file will contain specific information about the failure.

    Review the information about the failure, and then try to delete the project again.

    If partial data remains, you can also use the TFSDeleteProject command line tool.