title	titleSuffix	description	ms.technology	ms.assetid	ms.topic	ms.author	author	monikerRange	ms.date
witAdmin:Customize and manage objects for tracking work	TFS	Tracks your team's progress by creating and customizing objects that track work items.	devops-agile	7853f6db-98c9-4012-b6a5-51618c41d58c	reference	kaelli	KathrynEE	<= azure-devops-2019	03/20/2018

witAdmin: Customize and manage objects for tracking work

[!INCLUDE temp]

You can change how you track your team's progress by creating and customizing objects that track work items. By using the witadmin command-line tool, you can create, delete, import, and export objects such as categories, global lists, global workflow, types of links, and types of work items. You can also permanently delete types of work item types, and you can delete, list, or change the attributes of fields in work item.

Note

The witadmin command-line tool is not supported on Azure DevOps Services. Instead, you use inherited processes.

As the following illustration shows, you manage categories and types of and work items for each project. You manage global lists, types of links, and fields in work item for each project collection. You can customize global workflow for a project or a collection.

[!INCLUDE temp]

For most commands, you must be a member of the Project Administrators or Project Collection Administrators groups. For more information, see Add an administrator.

[!INCLUDE temp]

Global parameters

You can use the following parameters to display help text for witadmin.

Parameter	Description
/help or /?	Displays the syntax and parameters for the witadmin command-line tool.
command /help or command /?	Displays the syntax and parameters for the witadmin command that you specify.

witadmin commands

All work tracking objects—such as, work item types (WITs), process configuration, global lists— are customized by their XML definitions.

All witadmin commands can be run against an on-premises TFS. If you are new to work tracking customization and for definitions of the work tracking objects your can customize, see Customize your work tracking experience.