Delete a project

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

In this article, learn how to delete a project from Azure DevOps. Deleting a project helps simplify navigating to projects that are only in use.


Projects are permanently deleted if not restored within 28 days. For more information on restoring projects, see Restore a project. If you want to access project data while the project is deleted (without restoring it) you should save project data.


  • You must be a member of the Project Collection Administrators group or have the Delete team project permission set to Allow. If you're the Organization Owner, you're automatically added to the Project Collection Administrators group. If you aren't a member, get added now. For more information, see Set permissions at the project- or collection-level.

Delete project

  1. Sign in to your organization ({yourorganization}).

  2. Select gear icon Organization settings.

    Open Organization settings

  3. Select Projects, and then check one or more projects to delete. Select Delete.

    In Organization settings, select Projects, check each project, delete

  4. Confirm deletion by entering the organization name (in this example, the organization and project have the same name), and then select Delete in the popup screen.

    popup confirmation delete project screen

Your project is deleted and can be restored up to 28 days afterward.

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, and then choose Collection settings.

    Open Organization settings

  2. Select a service from the sidebar. Settings are organized based on the service they support. Expand or collapse the major sections such as Boards and Pipelines to choose a page.

    Organization settings, Projects

  1. Choose the Azure DevOps logo to open Projects, and then choose Organization settings.

    Open Collection settings

  2. Select a service from the sidebar. Settings are organized based on the service they support. Expand or collapse the major sections such as Boards and Pipelines to choose a page.

    Organization settings, Projects

  1. Choose the gear icon to open Collection Settings.

    Organization settings, Policy page, Security policies

  2. From there, you can choose a page. Settings are organized based on the service they support.

    Organization settings, Projects

Delete a project from TFS

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 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 start 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 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 project had a project portal, all links to that portal get removed from TWA and Team Explorer, but the SharePoint site or website that acted as the portal isn't 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 can't 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 didn't successfully finish. The log file contains 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.

You can delete a team project with the az devops project delete command. To get started, see Get started with Azure DevOps CLI.

az devops project delete --id


  • id: Required. The ID of the project you want to delete. To determine the ID of a project, use the az devops project list command.
  • org: Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up using git config. Example: --org
  • yes: Do not prompt for confirmation.


The following command deletes the team project with the specified ID without prompting you for confirmation.

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

Azure DevOps CLI commands aren't supported for Azure DevOps on-premises deployments at this time.