TFS 2017 Update 2 RC2 and work item type icons


Thanks for visiting.  If you have installed Update 2 RC1 or RC2 for TFS 2017 you may have noticed that all of your work item icons are different colored clip boards with a checkmark.  It doesn’t have to be this way 🙂



If you would like to use the new icons that are included with Update 2 you just need to update your ProcessConfiguration file for your Team Project.

Here are the icons that are included with Update 2 (image from Microsoft)


It is very easy to update your ProcessConfiguration file, you use the witadmin utility to export the ProcessConfiguration file make the change and then import it.

The witadmin tool installs with any version of Visual Studio (even the free version Visual Studio Community)

cd C:\Program Files (x86)\Microsoft Visual Studio 15.0\Common7\IDE
witadmin exportprocessconfig /p:DemoProject /collection: /f:"C:\Users\wes.macdonald\Documents\Agile\processconfig.xml"

Now open the processconfig.xml with notepad or your favorite text editor and locate the following XML tag <Properties> as shown below (left side):

processconfigxml-old-new All you need to do is add a new Property tag with the following attributes and values (right side)

<Property name=”WorkItemTypeIcons” value=”Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book, Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone, Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step, Shared Parameter=icon_test_parameter” />

Save the new processconfig.xml and import it using the witadmin utility

witadmin importprocessconfig /p:DemoProject /collection: /f:"C:\Users\wes.macdonald\Documents\Agile\processconfig.xml"


You should now see the new icons displayed after refreshing your browser.


If you wish to read more about the various properties and behaviors see the documentation located here.


About Wes MacDonald

Wes MacDonald is a DevOps Consultant for LIKE 10 INC., a DevOps consulting firm providing premium support, guidance and services for Azure, Microsoft 365 and Azure DevOps.

No comments yet... Be the first to leave a reply!

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: