{"id":20935,"date":"2016-09-02T19:45:46","date_gmt":"2016-09-02T23:45:46","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/?p=20935"},"modified":"2019-02-14T15:56:22","modified_gmt":"2019-02-14T23:56:22","slug":"custom-work-item-types-on-team-services","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/custom-work-item-types-on-team-services\/","title":{"rendered":"Custom work item types on Team Services"},"content":{"rendered":"<p><strong>NOTE 9\/13<\/strong><span>: The custom work item type feature should now be rolled out to all accounts. If you are not seeing it, please <a href=\"mailto:Derrick.Fu@microsoft.com\">reach out to me directly<\/a>.\u00a0<\/span><\/p>\n<p><strong>NOTE 9\/12<\/strong>: As evidenced by the comments, this feature is still rolling out across Team Services so not all accounts will see the custom work item type feature just yet. I apologize for the delay and will update this blog post when the deployment is finalized. ETA: early this week.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-1.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-1.png\" alt=\"custom wit 1\" width=\"742\" height=\"527\" class=\"alignnone wp-image-20937\" \/><\/a><\/p>\n<p>With the latest deployment to VSTS, you can now create your own custom work item types (WITs) and place them on the backlog and board level of your choice. Read on for a walk through of the process.<\/p>\n<h2>Create a custom work item type<\/h2>\n<p>If you do not already have one, you\u2019ll need to <a href=\"https:\/\/www.visualstudio.com\/en-us\/docs\/work\/process\/manage-process\">create an inherited process<\/a> and migrate your projects to use it. Once you have an inherited process, you\u2019ll notice a new button above the work item types list:<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-2.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-2.png\" alt=\"custom wit 2\" width=\"602\" height=\"425\" class=\"alignnone size-full wp-image-20945\" \/><\/a><\/p>\n<p>Click the New work item type button to\u00a0bring up the dialog. Here, you need to provide a name and, optionally, a description and color for your custom WIT. Currently, you can&#8217;t\u00a0rename a WIT, but \u00a0you can update the description and color\u00a0at a later time.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-3.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-3.png\" alt=\"custom wit 3\" width=\"494\" height=\"410\" class=\"alignnone wp-image-20955\" \/><\/a><\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-4.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-4.png\" alt=\"custom wit 4\" width=\"946\" height=\"734\" class=\"alignnone wp-image-20965\" \/><\/a><\/p>\n<p>Once you&#8217;ve created your WIT, you\u2019ll land on the layout page where you can customize your form layout and add new fields. Your WIT will have default states that you can also modify. Note: the existing limitations for states in the completed category still exist. See this topic\u00a0to\u00a0learn more:<a href=\"https:\/\/www.visualstudio.com\/en-us\/docs\/work\/process\/customize-process\">\u00a0https:\/\/www.visualstudio.com\/en-us\/docs\/work\/process\/customize-process<\/a><\/p>\n<h2>Add a custom work item type to a backlog and board level<\/h2>\n<p>Each work item type now has a new \u201cBacklogs\u201d tab that allows the process admin to choose where their custom WITs appear in the Agile experiences. You can&#8217;t change the inherited (system) WITs backlog level.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-5.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-5.png\" alt=\"custom wit 5\" width=\"905\" height=\"702\" class=\"alignnone wp-image-20975\" \/><\/a><\/p>\n<p>Choosing a new backlog level will give you details on the changes that will be made:<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-6.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-6.png\" alt=\"custom wit 6\" width=\"910\" height=\"706\" class=\"alignnone wp-image-20985\" \/><\/a><\/p>\n<p>Commit your change by clicking the \u201cSave\u201d button. Your custom WIT will then begin appearing on the selected backlog and board. You may have to refresh your web browser to see the changes.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-7.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-7.png\" alt=\"custom wit 7\" width=\"659\" height=\"272\" class=\"alignnone size-full wp-image-20995\" \/><\/a><\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-8.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-8.png\" alt=\"custom wit 8\" width=\"574\" height=\"272\" class=\"alignnone size-full wp-image-21005\" \/><\/a><\/p>\n<h2>Destroy a custom work item type<\/h2>\n<p>From the overview page of a custom WIT, you can destroy the WIT. Destroying a WIT will permanently delete all work items of that type as well as all references to the WIT. It also frees up the WIT name for reuse.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/6\/2019\/05\/custom-wit-9.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2016\/09\/custom-wit-9.png\" alt=\"custom wit 9\" width=\"901\" height=\"699\" class=\"alignnone wp-image-21015\" \/><\/a><\/p>\n<h2>Closing<\/h2>\n<p>In the next few weeks, we will be adding the ability to disable any WIT. Disabling a WIT will prevent new work items of that type from being created while still preserving existing work items on your backlog, board and queries. It will provide a way to get rid of unwanted inherited WITs and deprecate WITs.<\/p>\n<p>Please comment or <a href=\"mailto:Derrick.Fu@microsoft.com\">email<\/a> with any feedback or questions.<\/p>\n<p>Derrick Fu<\/p>\n","protected":false},"excerpt":{"rendered":"<p>NOTE 9\/13: The custom work item type feature should now be rolled out to all accounts. If you are not seeing it, please reach out to me directly.\u00a0 NOTE 9\/12: As evidenced by the comments, this feature is still rolling out across Team Services so not all accounts will see the custom work item type [&hellip;]<\/p>\n","protected":false},"author":206,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[227,1],"tags":[],"class_list":["post-20935","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-agile","category-devops"],"acf":[],"blog_post_summary":"<p>NOTE 9\/13: The custom work item type feature should now be rolled out to all accounts. If you are not seeing it, please reach out to me directly.\u00a0 NOTE 9\/12: As evidenced by the comments, this feature is still rolling out across Team Services so not all accounts will see the custom work item type [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/20935","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/206"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=20935"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/20935\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=20935"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=20935"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=20935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}