Customise the colours in Team Foundation Server 2013 Agile Planning Tools



If you want to customise the colours in Team Foundation Server 2013 Agile Planning Tools you need to download and edit the Process Configuration file that tells TFS how to configure many of the features in the Web Access.

There used to be two files in Team Foundation Server 2012 but this was confusing and the amalgamation to a single configuration file just made sense.

Figure: Colour coded Work Item Types are easy to distinguish

The colours that you pick will be displayed wherever a work item is displayed. Wither that is in a list or a card on one of the boards the same coloured bar will be displayed on the left. This really helps distinguish between them and highlights things like Bugs in a list of Product Backlog Items.

To configure this we need to first export (download) the existing processing configuration to a location we can find.

$TeamProjectName = "teamswithareas"
$tempFolder = "C:temp"
$CollectionUrl = "http://kraken:8080/tfs/tfs01"
$WitAdmin = "${env:ProgramFiles(x86)}Microsoft Visual Studio 12.0Common7IDEwitadmin.exe"

# Export the existing Processing configuration
& $WitAdmin exportprocessconfig /collection:$CollectionUrl /p:$TeamProjectName /f:"$tempFolderProcessConfiguration.xml"

Once you have that we need to find and edit the colours and Paint as usual does not cut the mustard. You will need to know the hex value of the colours and that can be easily found if you use something like Paint.Net or where they let you pick colours.

Note These colours are 8 digit HEX as they include transparency. The first two digits are the setting for transparency and “FF” denotes fully visible.

  <workitemcolor name="Product Backlog Item" secondary="FFD6ECF2" primary="FF009CCC" />
  <workitemcolor name="Feature" secondary="FFEEE2F2" primary="FF773B93" />
  <workitemcolor name="Task" secondary="FFF6F5D2" primary="FFF2CB1D" />
  <workitemcolor name="Bug" secondary="FFFAEAE5" primary="FFCC293D" />
  <workitemcolor name="Code Review Request" secondary="FFFCEECF" primary="FFFF9D00" />
  <workitemcolor name="Code Review Response" secondary="FFFCEECF" primary="FFFF9D00" />
  <workitemcolor name="Feedback Request" secondary="FFFCEECF" primary="FFFF9D00" />
  <workitemcolor name="Feedback Response" secondary="FFFCEECF" primary="FFFF9D00" />
  <workitemcolor name="Impediment" secondary="FFFCEECF" primary="FFFF9D00" />
  <workitemcolor name="Shared Steps" secondary="FFFCEECF" primary="FFFF9D00" />
  <workitemcolor name="Test Case" secondary="FFFCEECF" primary="FFFF9D00" />

If you open the XML and look for the “workitemcolors” element (no idea why they insist on spelling it wrong) you will find an entry for each of the Work Item Types available.

$TeamProjectName = "teamswithareas"
$tempFolder = "C:Temp"
$CollectionUrl = "http://kraken:8080/tfs/tfs01"
$WitAdmin = "${env:ProgramFiles(x86)}Microsoft Visual Studio 12.0Common7IDEwitadmin.exe"

# Import the new Processing configuration
& $WitAdmin importprocessconfig /collection:$CollectionUrl /p:$TeamProjectName /f:"$tempFolderProcessConfiguration.xml"

All we need to do is edit the colour codes and then import (upload) the process configuration again. Here I am going to change the PBI to Pink (#FF16D0) which has a value of FFFF16D0 with a secondary (faded) colour of FFFFD1D0.

Figure: Lovely pink PBI’s

And voilà you now have just what you always wanted… pink PBI’s.

Upcoming Training Opportunities

These are the next five classes we have, and you can check out our full public schedule of classes.

Live Virtual Professional Scrum Product Owner online 5th June 2023
5-8 Jun, 2023
09:30-13:30 BST
4 half-days
Live Virtual PAL Evidence-Based Management Online on 19th June 2023
19-20 Jun, 2023
09:00-13:00 BST
2 half-days
APS 19th June 2023
19-22 Jun, 2023
09:00-13:00 EDT
4 half-days
Live Virtual Professional Scrum Master Online on 26th June 2023
26-29 Jun, 2023
09:00-13:00 EDT
4 half-days

We can deliver any of our courses as private in-house training over Microsoft Teams & Mural. We also recommend training based on your accountabilities or role, you can go directly to recommended courses for Scrum MastersProduct OwnersDevelopers and Agile Leaders.

Create a conversation around this article

Share on Facebook
Share on Twitter
Share on Linkdin

Related Courses

No items found

Read more

Martin Hinshelwood Why do you encourage people to follow a certification path in their career journey? I would encourage you to follow a scrum certification path for the same reason that people go to university. The same reason that people do any course or certification. It gets you a foot in …
Martin Hinshelwood What will you learn on the PSM II course? There are two main things that most scrum masters will learn on the PSM II or Advanced Professional Scrum Master course. That they haven’t been working effectively as a scrum master to date. That they are there to empower and …
Martin Hinshelwood
In Scrum Events across the world, I hear repeated the phrase “that’s how agile works” when describing behaviours that are both unprofessional and the very opposite of an agile mindset. These behaviours will inhibit agility and are a result of a lack of understanding of the underlying principles. We need …
Martin Hinshelwood What is the most common Aha moment people have in a scrum course? It depends on the scrum course they are attending. The content presented in the Applying Professional Scrum (APS) course leads to very different epiphanies when compared to the content presented on an Advanced Professional Scrum Master …


We believe that every company deserves high quality software delivered on a regular cadence that meets its customers needs. Our goal is to help you reduce your cycle time, improve your time to market, and minimise any organisational friction in achieving your goals.

naked Agility Limited is a professional company that offers training, coaching, mentoring, and facilitation to help people and teams evolve, integrate, and continuously improve.

We recognise the positive impact that a happy AND motivated workforce, that has purpose, has on client experience. We help change mindsets towards a people-first culture where everyone encourages others to learn and grow. The resulting divergent thinking leads to many different ideas and opportunities for the success of the organisation.