blog

How to rename a Team Project in TFS 2015

Published on
3 minute read

By the launch of TFS 2010 we had given up on getting rename in TFS. 5 years of no rename had taken its toll. Now, as a surprise present with TFS 2015 (and on VSO) and I have a bunch of projects to “zz”. Did you know that you should always “zz” something before you delete it. If you delete something then its gone. If you prefix it with “zz” then it falls to the bottom of any list and you can ignore it until later… but if someone complains… you can easily recover it.

[pl_button type=“info” link=“ https://www.visualstudio.com/en-us/downloads/visual-studio-2015-downloads-vs.aspx"  target=“blank”]Download 2015 today[/pl_button]

Renaming your Team Project is easy. You will need to be a Team Project Administrator, and there are some caveats and advanced instructions, but …

How to rename a Team Project in TFS 2015

You need to first access the admin page for your Team Project first. Make sure that you are currently selected on the Default Team in your team project. You are on the default team if it just says the “Team Project” name at the top of your browser rather than “Team Project \ Team” if you are on a non-default team.

How to rename a Team Project in TFS 2015

Once in the admin you can see the name below the profile picture, and up until now that was not editable. Now however you can change the team project name by simply selecting the team project name and changing the text.

How to rename a Team Project in TFS 2015

Once you start editing it you will have a “save” and “undo” button. Click “save” to start the Process to change the team project name.

How to rename a Team Project in TFS 2015

You will be warned that there is an impact to this. Remember that the name is used in a lot of the URL’s and not all clients will support this gracefully. By the time TFS 2015 RTM’s Visual Studio 2010 will be out of mainstream support and there will be no requirement for the product team to make sure that Visual Studio 2010 supports renaming a team project. To get the best compatibility and easiest transition you should make sure that all the clients are updated to Visual Studio 2013 Update 5 or Visual Studio 2015. However Visual Studio 2012 and other versions will be supported, it just might not be without a little tinkering… like clearing the cache or reconfiguring your TFS connection.

How to rename a Team Project in TFS 2015

If you have a busy TFS server then it may have to wait a while for the task to complete, but in the 5 renames I have done so far all of them took less than 10 seconds to complete. I have only currently renamed the team projects that are no longer needed and not yet hit an in-use project, but that is the plan for later in the week.

How to rename a Team Project in TFS 2015

Once you click “close” the page will refresh and the new team project name will be presented. At this point the old name will still work. If you hit it you will get the right page an all of the links from there will be the new name. This ‘redirect’ will be there until he old name is reused. So from the web access there should be minimal impact.

How to rename a Team Project in TFS 2015

You can see the four renames I have done so far and the additional three proposed for the end of the week. We will be picking a lightly used one first so that we can gauge the impact, and then roll on with the rest.

install-and-configuration blog team-project tfs tfs-2015

Connect with Martin Hinshelwood

If you've made it this far, it's worth connecting with our principal consultant and coach, Martin Hinshelwood, for a 30-minute 'ask me anything' call.

Our Happy Clients​

We partner with businesses across diverse industries, including finance, insurance, healthcare, pharmaceuticals, technology, engineering, transportation, hospitality, entertainment, legal, government, and military sectors.​

Genus Breeding Ltd Logo
Workday Logo
Akaditi Logo
Healthgrades Logo
SuperControl Logo
YearUp.org Logo
Trayport Logo
Lockheed Martin Logo
Alignment Healthcare Logo
Milliman Logo
Jack Links Logo
New Signature Logo
Kongsberg Maritime Logo
Boxit Document Solutions Logo
Epic Games Logo
Emerson Process Management Logo

CR2

ALS Life Sciences Logo
Ghana Police Service Logo
Royal Air Force Logo
Washington Department of Enterprise Services Logo
Nottingham County Council Logo
Washington Department of Transport Logo
Department of Work and Pensions (UK) Logo
Schlumberger Logo
Capita Secure Information Solutions Ltd Logo
Sage Logo
Qualco Logo
Brandes Investment Partners L.P. Logo
Emerson Process Management Logo