Move work items, change work item type

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019

Often times you find that someone created a work item of the wrong work item type (WIT) or within an incorrect project. You can correct these issues for individual work items or bulk modify several work items. You can also remove work items added to your backlog or taskboard that aren't relevant anymore.

Tip

For TFS 2018 and earlier versions, you can't change the work item type for an existing work item, but you can copy the work item and specify a new type. Also, if you have several work items with type changes you want to make, you can export them using Excel, and then re-add them as a new type.

In this article you'll learn:

  • How to change the work item type of one or more work items
  • How to move one or more work items to another project

Tip

From the web portal, you can multi-select several work items from a backlog or query results page and perform a bulk update using the associated feature. To change, move, delete, or restore several work items at the same time, see Bulk modify work items.

Prerequisites

  • You must connect to a project. If you don't have a project yet, create one.
  • You must be added to a project as a member of the Contributors or Project Administrators security group. To get added, Add users to a project or team.
  • To modify work items, you must have your View work items in this node and Edit work items in this node permissions set to Allow. By default, the Contributors group has this permission set. To learn more, see Set permissions and access for work tracking.
  • To change the work item type, you must be granted Stakeholder access or higher. For details, see About access levels.
  • To move work items to another project, you must be a member of the Project Administrators group or have the Move work items out of this project permission set to Allow. By default, the Contributors group doesn't have this permission set.

Note

Users with Stakeholder access for a public project have full access to all work tracking features just like users with Basic access. For details, see About access levels.

  • You must connect to a project. If you don't have a project yet, create one.

  • You must be added to a project as a member of the Contributors or Project Administrators security group. To get added, Add users to a project or team.

  • To modify work items, you must have your View work items in this node and Edit work items in this node permissions set to Allow. By default, the Contributors group has this permission set. To learn more, see Set permissions and access for work tracking.

  • To move work items to another project, the project must use an Inherited process model.

  • To move work items to another project, you must be a member of the Project Administrators group or have the Move work items out of this project permission set to Allow. By default, the Contributors group doesn't have this permission set.

  • To change the work item type, you must be granted Stakeholder access or higher. For details, see About access levels.

    Important

    You can change the work item type or move work items to another project within a project collection. These features require that the data warehouse is disabled. With the data warehouse disabled, you'll use the Analytics Service to support your reporting needs. To learn more about disabling the data warehouse, see Disable the data warehouse and cube.

To learn more, see Set permissions and access for work tracking or Set permissions at the project-level or project collection-level.

Important

You can't change type or move work items whose work item types support test management or that belong to the Hidden Types Category. This includes all work items that track tests—such as test cases, shared steps, and shared parameters—code review requests and responses, and feedback requests and responses.

Important

You can't change type, move work items, or delete/restore work items whose work item types support test management or that belong to the Hidden Types Category. This includes all work items that track tests—such as test cases, shared steps, and shared parameters—code review requests and responses, and feedback requests and responses.

Also, you can't change the work item type if the project is defined on a collection that uses the On-premises XML process model.

Change the work item type

Changing the work item type refreshes the work item form with the fields defined for the type selected. For example, you can change a bug to a task and the form will refresh with the fields defined for a task.

Note

You can't change the work item type of work items associated with test management. Also, you can't change the work item type if the project is defined on a collection that uses the On-premises XML process model.

You can change a single work item or several multi-selected work items to a new type.

  1. Open a work item, choose the actions icon, and select the Change type... option.

    Work item form, Change work item type menu option

    Or, from the backlog or query results page, multi-select several work items whose type you want to change. You can select several work items of the same type or different type so long as you want to change them all to the same work item type.

    Choose the actions icon, and select the Change type... option.

    Backlog, multi-select, open actions menu, choose Change type option

    Important

    From the Query results page, the Change type… option becomes unavailable if you have checked the Query Editor's Query across projects checkbox.

  2. Select the type and optionally enter a comment.

    Change work item type dialog

    Comments are automatically added to the Discussion control.

  3. Save the work item to complete the change.

    Note

    The system automatically resets the State and Reason fields to the default initial values of the specified type.

    From the Query results page, you must save all work items that you bulk-modified. When you bulk modify items from the backlog, they are automatically saved. Work items shown in bold text indicate that local changes have not yet been saved to the data store. The system automatically saves each work item. Refresh the page to reflect your changes.

Move a work item to another project

When you discover that a work item belongs to a different project within your organization or collection, you can move it where it belongs. You can move a single work item or several multi-selected work items.

You can only move work items from one project to another project within the organization or collection. You can't move work items associated with test management. To move work items to another project, you must be a member of the Project Administrators group or be granted explicit permissions to move work items.

  1. Open the work item and choose the Move work item icon Move... option from the work item form's Action icon Actions menu.

    If you don't see the option, then you haven't been granted permissions to move work items out of the project.

    Or, from the backlog or query results page, multi-select several work items whose type you want to change. You can select several work items of the same type or different type so long as you want to change them all to the same work item type.

    Choose the actions icon to open the context menu of one of the selected work items, and choose the Move work item icon Move… option.

  2. Select the destination project and optionally enter a comment.

    Move work item type dialog

    Comments are automatically added to the Discussion control and an entry is made to the History control. Also, the system automatically resets the State and Reason fields to the default initial values for the work item type that you move.