How to delete a team project from Team Foundation Service using the web UI


[Update 18 Nov. 2013] It is now easier to get to the UI to delete a project. Navigate to the home page for your team project, then click on the gear icon in the upper left, and then you can click on the drop down arrow that will show up when you mouse over the name of the team project.

You now have the ability to delete a team project from TF Service using the web UI rather than the command line (the command line still works, and you can find the instructions here if you need them). Unfortunately, this only applies to the service. In the future, we plan to have both team project creation and deletion be available from the web UI for the on-premises server, but we haven’t gotten to it yet.

However, it’s a bit hidden. Here’s how to find it. First, go to the project home page for one of your team projects (you’ll need to be an account admin) and click on the gear icon in the upper right. It doesn’t matter at this point which team project you pick. Doing this will open a new tab with the administrative web page in it.

image

Next, click on DefaultCollection in the navigation area in the upper left. Doing this will take you to a list of team projects.

image

In the list of team projects, you will see a drop down arrow to the left of a team project name when you hover over the name with you mouse. Clicking on that drop down arrow will give you the option to delete the team project. Here I am deleting a team project called Awesome.

image

Now you will be presented with a dialog to confirm deletion of the team project. Be sure you really want to delete the entire team project. The code, work items, etc. will all be destroyed on the server. There is no way to recover from this operation (it’s not a soft delete at this point – it’s in our plans for the future). So, be certain you want to delete the team project (and double check that the name in the dialog is the one you want to delete)!

image

If you choose to delete the team project, you will see a progress bar. The time to delete a project depends on how large it is. For an empty team project, it will be done in seconds.

image

That’s all there is to it. Just be careful that you don’t delete something you care about!

Follow me on Twitter at twitter.com/tfsbuck

Comments (19)

  1. DataProfound says:

    "However, it’s a bit hidden"

    You can say that again! In any case, thank you for the functionality as it drove me crazy having empty/old projects display for no good reason.

  2. I can hover the arrow to get the Delete option, but cannot click it. Is this a permissions issue?

  3. buckh says:

    Martin, that sounds like an issue in the browser itself – some sort of bug. Try a force refresh (holding Ctrl and clicking the refresh button in the browser) or a different browser.

    1. James Sneeringer says:

      I have the same problem shown below and have tried both solutions. The browsers I tried are IE, Edge, and Chrome. The menu item seems to be disabled.

      Any other ideas?

      mkozma@hotmail.com
      September 30, 2013 at 7:00 pm
      I can hover the arrow to get the Delete option, but cannot click it. Is this a permissions issue?

      buckh
      September 30, 2013 at 8:31 pm
      Martin, that sounds like an issue in the browser itself – some sort of bug. Try a force refresh (holding Ctrl and clicking the refresh button in the browser) or a different browser.

  4. AnimeshB says:

    Removing a project and changing the URL were the two biggest things I needed and they are now delivered. Thanks.

  5. buckh says:

    Glad to hear it!

  6. Sandeep says:

    Thanks Buck

    This is exactly I was looking for.

    Wonder, why it has to be so hidden and mysterious

  7. Mauricio Sougarret says:

    Excellent, a much needed feature!!! I've already deleted several old Projects!!! Thanks again

  8. Thomas Morris says:

    This is great, however is there any way to rename a project? Or is there a link as to how you change the URL for a project as mentioned by AnimeshB above? Thanks!

  9. buckh says:

    Thomas, there is still no way to rename a project. You can change the URL to your account but not to a project.

  10. Thomas Morris says:

    Thanks Buck. I wonder if there is an option to export and import projects?

  11. buckh says:

    Thomas, there's no way to use export/import to rename team projects. It's a feature we really need and just don't have.

  12. Marcus says:

    not working, gave up after 1/2 hours

    again a worse GUI from MS

  13. buckh says:

    Marcus, sorry to hear it was such a bad experience. Would you tell me your account URL? I would like to investigate that b

  14. clemmend says:

    It worked for me. Marcus, if you are still having this issue you might want to ask a question at the Visual Studio Online forum (social.msdn.microsoft.com/…/home), and provide more details, such as browser version.

  15. Zohra says:

    Thank you!  I couldn't figure out how to delete it!

  16. Paul says:

    This must be an Online feature only as Delete is disabled in the local server based TFS

  17. buckh says:

    Paul, unfortunately that is true. We have plans to have project creation in the web UI for TFS, and at that time we would have the work done to support deletion as well.

  18. Justin Wignall says:

    Through a combination of setting Allow Delete Project from the security tab and then going to the Collection Overview from the breadcrumb navigation rather than inside the actual project andt then selecting the delete option from the context menu next to the project name there I was able to delete a project from VSO. Tricky but possible.