title	titleSuffix	description	ms.service	ms.custom	ms.author	author	ms.topic	monikerRange	ms.date
Copy or clone test plans, test suites, test cases, or other test items	Azure Test Plans	Learn how to copy or clone test plans, test suites, test cases in Azure Test Plans.	azure-devops-test-plans	cross-project, UpdateFrequency3	rbatra	raviLiftr	tutorial	<= azure-devops	11/11/2021

Copy or clone test plans, test suites, and test cases

[!INCLUDE version-lt-eq-azure-devops]

Several tools support copy, clone, or import operations of test items such as test plans, test suites, and test cases. Test cases describe the steps to take to run a test and validate a feature implementation or bug fix. Test suites group test cases, and optionally other test suites, into a particular order. Test plans define a collection of test suites to run for a particular iteration or release.

Each test case is designed to confirm a specific behavior. Test cases may belong to one or more test suites, however test suites can belong to one and only one test plan.

In general, you should create a test plan for every major project milestone. Copy, clone, or import operations of test items support the following scenarios:

Define a test plan for a new sprint or release based on an existing test plan
Import test suites from one test plan to another test plan within the same or different project
Copy test cases for use in different test suites and test plans
Share test objects across projects
Move test objects from one project to another, possibly to support consolidating projects into a single project.

For an overview of test objects and terminology, see Test objects and terms.

Supported copy, clone, and import tools

Depending on the Azure DevOps version you use, you can use the clients or tools listed in the following table to copy, clone, or import test plans, test suites, or test cases.

:::row::: :::column span="1"::: Client/tool
:::column-end::: :::column span="1"::: Test Plans :::column-end::: :::column span="1"::: Test Suites :::column-end::: :::column span="1"::: Test Cases :::column-end::: :::row-end:::

::: moniker range=">= azure-devops-2020" :::row::: :::column span="1"::: Web portal ¹
:::column-end::: :::column span="1"::: ✔️ (Copy) :::column-end::: :::column span="1"::: ✔️ (Import) :::column-end::: :::column span="1"::: ✔️ (Copy)
✔️ (Bulk export/import)
:::column-end::: :::row-end::: ::: moniker-end ::: moniker range=">= azure-devops-2020" :::row::: :::column span="1"::: Web portal (Grid)
:::column-end::: :::column span="1":::

:::column-end::: :::column span="1":::

:::column-end::: :::column span="1"::: ✔️ (Copy and paste) :::column-end::: :::row-end::: ::: moniker-end ::: moniker range="< azure-devops-2020" :::row::: :::column span="1"::: Web portal (Grid)
:::column-end::: :::column span="1":::

:::column-end::: :::column span="1":::

:::column-end::: :::column span="1"::: ✔️ (Copy and paste) :::column-end::: :::row-end::: ::: moniker-end :::row::: :::column span="1"::: Work item form
:::column-end::: :::column span="1":::

:::column-end::: :::column span="1":::

:::column-end::: :::column span="1"::: ✔️ (Copy) :::column-end::: :::row-end::: ::: moniker range="<= azure-devops-2019" :::row::: :::column span="1"::: Microsoft Test Manager¹
(deprecated) :::column-end::: :::column span="1"::: ✔️ (Clone plan) :::column-end::: :::column span="1"::: ✔️ (Copy a test suite) :::column-end::: :::column span="1"::: ✔️ (Create copy) :::column-end::: :::row-end::: ::: moniker-end :::row::: :::column span="1"::: TCM CLI ²
:::column-end::: :::column span="1"::: ✔️ (Clone) :::column-end::: :::column span="1"::: ✔️ (Clone) :::column-end::: :::column span="1"::: ✔️ (Import automated) :::column-end::: :::row-end::: ::: moniker range=">= azure-devops-2019" :::row::: :::column span="1"::: REST API ³
:::column-end::: :::column span="1"::: ✔️ (Clone) :::column-end::: :::column span="1"::: ✔️ (Clone) :::column-end::: :::column span="1":::

:::column-end::: :::row-end::: ::: moniker-end

Note

::: moniker range=">= azure-devops-2020"

With the release of Azure DevOps Server 2020, the web portal for Azure Test Plans was significantly updated. Many new features were added to support copy, clone, import, and export. For an overview, see Navigate Test Plans.
The Test Case Management (TCM) command-line tool is installed when you install Visual Studio 2017 or earlier versions. Examples provided in this article reflect the options available with the Visual Studio 2017 version. Earlier versions may support fewer options. For details, see Work with the TCM command-line tool.
REST API commands to support cloning of test plans and test suites were added with version 5.0, corresponding with Azure DevOps 2019. ::: moniker-end ::: moniker range="< azure-devops-2020"
Microsoft Test Manager (MTM) was deprecated for use with Azure DevOps Services in January 2020, and isn't supported for Azure DevOps Server 2020 and later versions. The current version of Azure Test Plans supports all features that MTM supported and more.
The Test Case Management (TCM) command-line tool is installed when you install Visual Studio 2017 or earlier versions. Examples provided in this article reflect the options available with the Visual Studio 2017 version. Earlier versions may support fewer options. For details, see Work with the TCM command-line tool. ::: moniker-end

[!INCLUDE prerequisites-define]

List test plans or test suites

You often need to know the ID assigned to a test plan or test suite to support copy, clone, or import operations.

Browser

You can generate a list of test plans, test suites, or other test objects from the Boards>Queries page. For example, by setting the Work Item Type=Test Plan, you can list all test plans defined for the team project. If you choose the Query across all projects checkbox, the query will list all test plans defined for all projects. To learn more about defining queries, see Define a work item query.

Tip

While test plans, test suites, and test cases are related to each other, you can't view the relationships through a work item query. Link types aren't used to link test plans, test suites, and test cases. Only shared steps and shared parameters are linked to test cases. Also, test cases are linked to user stories or other work items that they test.

:::image type="content" source="media/copy-clone/query-test-plans.png" alt-text="Screenshot of Query Editor, Query test plans.":::

TCM CLI

TCM supports listing of test plans and test suites. Lists specify the work ID for each test plan or test suite. This ID is the same as a plan ID or suite ID.

List test plans | List test suites

List test plans

Use tcm plans /list to determine the ID for a test plan. The ID corresponds to the work item ID defined when the test plan was created.

tcm plans /list [/planid:id  |  /querytext:query] /collection:teamprojectcollectionurl
           /teamproject:project [/login:username,[password]]

Parameter	Description
/querytext:`query`	Optional. Specifies the query to use to list a subset of test plans.

[!INCLUDE prerequisites-define]

Example

The following command lists the test plans defined for the Fabrikam Fiber project hosted in the fabrikamprime organization. The ID and Name corresponds to the work item ID and Title defined for the test plan. For example, test plan 86 is titled Hello World Test.

tcm plans /list /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"

Id        Name
--------- ----------------------------------------------------------------
66        Sprint 1
72        All sprints
77        Sprint 2
86        Hello World Test

List test suites

Use tcm suites /list to list the test suites with their work item IDs. When no optional parameters are specified, all test suites are listed for the team project.

tcm suites /list [/planid:id  |  /querytext:query] /collection:teamprojectcollectionurl
           /teamproject:project [/login:username,[password]]

Parameter	Description
/planid:`id`	Optional. Specifies the ID of the plan to reference the test suites to list.
/querytext:`query`	Optional. Specifies the query to use to list a subset of test suites.

[!INCLUDE prerequisites-define]

Example

The following command lists the test suites defined for the Fabrikam Fiber project hosted in the fabrikamprime organization. The ID corresponds to the work item ID defined for the test suite. Under the Name column, the first entry indicates the test plan that the test suite is defined under. Following the -> (arrow) is the Title of the test suite or the Title of a parent test suite. For example, test suite 75, Sub Suite 01, is a sub-test suite of Suite 01 defined for the All sprints test plan.

tcm suites /list /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber" 

Id        Name
--------- ----------------------------------------------------------------
67        Sprint 1
68        Sprint 1 -> 33 : Change initial view
69        Sprint 1 -> 34 : Welcome back page
70        Sprint 1 -> 43 : Cancel order form
73        All sprints
74        All sprints -> Suite 01
75        All sprints -> Suite 01 -> Sub Suite 01
78        Sprint 2
87        Hello World Test

Copy or clone test plans

We recommend creating a new test plan per sprint or release. When doing so, generally you can clone the test plan for the prior cycle and, with few changes, the copied test plan is ready for the new cycle.

Cloning is useful when you want to branch your application into two versions. After cloning, tests for the two versions can be changed without affecting each other.

:::image type="content" source="media/copy-clone/clone-test-plan-conceptual.png" alt-text="Conceptual image, clone test plan.":::

Browser

::: moniker range=">= azure-devops-2020"

Note

If you're new to using Azure Test Plans, review Navigate Test Plans to understand how to use the user interface to access select functions.

Open Test Plans>Test plans, and choose the test plan you want to copy from the Mine or All page. Select :::image type="icon" source="../media/icons/more-actions.png" border="false"::: More actions, and choose the Copy test plan menu option. This option lets you copy or clone test plans within a project.

:::image type="content" source="media/copy-clone/copy-test-plan-menu-selection.png" alt-text="Test Plan More Actions menu, copy test plan option.":::
Specify the name of the new test plan, and select an Area Path and Iteration Path for the plan.

:::image type="content" source="media/copy-clone/copy-test-plan-dialog.png" alt-text="Copy test plan dialog":::

Choose one or the other radio-buttons based on the following guidance:
- Reference existing test cases: Choose this option when you plan to merge the two branches eventually. In this case, you'll want to keep the same requirements for functionality that has already been implemented and tested.
- Duplicate existing test cases: Choose this option when you want to make new user stories or requirements that you will maintain separately. If you plan to diverge into two similar but separate applications, you might want to change the user stories of one without changing the stories of the other. Choosing this option creates an independent set of requirements for the new test cases.
If you duplicate existing test cases, the copied test cases will be assigned the Area Path and Iteration Path specified for the cloned test plan.

To learn more about area and iteration paths, see About area and iteration (sprint) paths.
The page refreshes to display the newly copied test plan.

:::image type="content" source="media/copy-clone/copied-test-plan.png" alt-text="Copied test plan, browser view":::
Update any query-based suites that you copied to use the new area and iteration paths.
Specify a build in the destination test plan if you have cloned automated test cases.

::: moniker-end

::: moniker range="< azure-devops-2020"

Note

This feature isn't supported through the web portal for Azure DevOps Server 2019 and earlier versions. The feature to copy test plans requires Azure DevOps Server 2020 or later version.

::: moniker-end

TCM CLI

You can use the TCM command-line tool to clone a test plan to the same or different project, and to track the status of the clone operation.

List test plans | Clone a test plan | Track test plan clone status

Clone a test plan

Use tcm plans /clone to initiate a cloning operation of all test cases from one test suite to a different destination suite within the same project. The destination suite must be defined and exist in a different plan. All contained suites and test cases are cloned. The command may return an operation ID that you can use to track the status and completion of the clone operation. When the clone operation completes quickly, no operation ID is returned.

tcm plans /clone /sourceplanid:id /destinationplanname:name
          [/overridefield:name=value [/overridefield:name=value ...]]
          [/sourcesuiteids:suiteid1,[suiteid2,...]]
          /collection:teamprojectcollectionurl /teamproject:project
          [/login:username,[password]]
          [/clonerequirements]
          [/clonechildren]

The /clone /sourceplanid /destinationplanname creates a new plan. If you specify /sourcesuiteids, the command initiates a clone operation to clone the test cases to the new plan. The command returns an operation ID that can be used to track status and completion of the clone operation.

Parameter	Description
/sourceplanid:`id`	Required. Specifies the ID of the plan to be copied, and the ID of the suite into which the new copy will be added. If you want to copy a whole test plan, use the ID of the suite at the root of the test plan.The ID of a suite is displayed in the details pane when you select it in the test plan. You can also get a list of suites by using `tcm suites /list`.
/destinationplanname:`name`	Specifies the name of the plan into which the cloned test plan will be copied.
/overridefield:`name=value` /overridefield:`name=value`	Optional. Specify to change the value of a field in each cloned work item. Specify multiple occurrences of this parameter to change as many fields as you want. This option is required when you clone a test suite to a different project.
/sourcesuiteids:`suiteid1,[suiteid2,...`	Optional. Specifies source test suites within the test plan to copy.
/clonerequirements	Optional. Specifies to clone requirements category work items that are attached to requirements-based test suites. If you omit this parameter, requirements-based test suites are converted to static suites.
/clonechildren	Optional. Specify to clone all child suites of the suites provided.
/clonerequirements	Optional. Specify this switch to clone a requirement-based suite to a destination requirement-based suite. By default, a requirement-based test suite is cloned to a destination static test suite. Can only specify this option when `/sourcesuiteids` is provided.

[!INCLUDE prerequisites-define]

Example

The following example clones test plan 66 to a new test plan titled Test plan, Release 3, which is then assigned the ID 118.

tcm plans /clone /sourceplanid:66 /destinationplanname:"Test plan, Release 3" /overridefield:"Iteration Path"="Fabrikam Fiber\Release 3" /overridefield:"Area Path"="Fabrikam Fiber\Web" /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"
Plan created with ID: 118

Clone operation is complete.

Track the status of the test plan clone operation

Use tcm plans /clone /status to retrieve the status of the clone operation made with tcm suites /clone. Test suites that contain a large number of test cases can take a considerable time to clone.

tcm plans /clone
           /status:cloneoperationid
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]]

Parameter	Description
/status:`cloneoperationid`	Required. Specifies the ID of the clone operation returned when `tcm plans /clone` executes.

[!INCLUDE prerequisites-define]

Import or clone test suites

When you're creating the test plan for a new sprint, you often want to repeat some of the tests from the previous sprints, to make sure that the functionality you already implemented still works.

:::image type="content" source="media/copy-clone/copy-test-suite-conceptual.png" alt-text="Conceptual image, copy test suites.":::

Note the following:

When you import (Web) or clone (TCM) a test suite to a new project, the new suite will contain copies of all test cases in the source suite. However, it won't retain any historical data like the previous test runs, related bugs, old results.
Shared steps referenced by the test cases are also cloned and created in the destination project.
You can't clone test cases from and to the same test plan, even into a different suite. To accomplish this scenario, you must first move the test cases to a different, temporary test plan. Then, use the temporary test plan as the source plan and clone the test cases back to the source test plan by putting the ID into the destination test plan place. Shared steps present in the test cases will also be duplicated in this process.

::: moniker range=">= azure-devops-2020"

You can use the user interface to import a test suite from one test plan, within the same or different project, to another test plan in the current project. This action essentially copies or clones the test suite, creating a new test suite and duplicating any sub-test suites. The test cases referenced by the test suites are not duplicated, but referenced by the cloned test suites. ::: moniker-end

You can use tcm suites /list to list all test suites defined for a project.

In order to use the same test cases in different suites and plans, copy and paste test cases using the Grid view. To learn more, see (XLink to be provided)

Browser

::: moniker range=">= azure-devops-2020"

Open Test Plans>Test plans, and choose the test plan where you want to import a test suite from the Mine or All page. Select :::image type="icon" source="../media/icons/more-actions.png" border="false"::: More actions, and choose the Copy test plan menu option. This option lets you copy or clone test plans within a project.

:::image type="content" source="media/copy-clone/import-test-suites.png" alt-text="Test Suite More Actions menu, Import test suites option.":::
In the dialog that opens, choose the project if the test plan resides in a different project. Otherwise, select the test plan and test suite and then choose Create. You can only import one suite from a test plan at a time.

:::image type="content" source="media/copy-clone/import-suites-from-test-plan-dialog.png" alt-text="Import suites from a Test Plan dialog":::
The following message displays:

:::image type="content" source="media/copy-clone/import-suites-message-1.png" alt-text="Import suites initiated message.":::
When the import operation completes, you'll see the following message. Choose Refresh to refresh your browser.

:::image type="content" source="media/copy-clone/import-suites-message-2.png" alt-text="Import suites completed message.":::

The newly added test suite then displays.

:::image type="content" source="media/copy-clone/imported-test-suite-displayed.png" alt-text="Imported test suite displayed.":::

::: moniker-end

::: moniker range="< azure-devops-2020"

Note

This feature isn't supported through the web portal for Azure DevOps Server 2019 and earlier versions. The feature to import test suites requires Azure DevOps Server 2020 or later version.

::: moniker-end

TCM CLI

You can use the TCM command-line tool to clone a test plan to the same or different project, and to track the status of the clone operation.

List test suites | Clone a test suite | Track test suite clone status

Clone a test suite

Use tcm suites /clone to initiate a cloning operation of all test cases from one test suite to a different destination suite within the same project by default. The destination suite must be defined and exist in a different plan. All contained suites and test cases are cloned. The command returns an operation ID that you can use to track the status and completion of the clone operation.

The following options provide support for optional clone operations:

/destinationteamproject: Clone a suite to a different project.
/destinationworkitemtype: Specify the work item type to use when cloning the test cases. Specify this option when cloning test cases to a custom work item type.
/overridefield: Override the values for select fields, such as the Area Path and Iteration Path fields, which is required when cloning to a different project. Or override the value of other fields to distinguish cloned test cases from the original.
/clonerequirements: Specify this switch to clone a requirement-based suite to a destination requirement-based suite.

tcm suites /clone
           /suiteid:id /destinationsuiteid:id
           [/overridefield:name=value [/overridefield:name=value ...]]
           [/destinationteamproject:projectname]
           [/destinationworkitemtype:workitemtype]
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]] [/clonerequirements]

Parameter	Description
/suiteid:`id`	Specifies the ID of the suite to be copied, and the ID of the suite into which the new copy will be added. If you want to copy a whole test plan, use the ID of the suite at the root of the test plan. The ID of a suite is displayed in the details pane when you select it in the test plan. You can also get a list of suites by using `tcm suites /list`.
/overridefield:`name=value` /overridefield:`name=value`	Optional. Specify to change the value of a field in each cloned work item. Specify multiple occurrences of this parameter to change as many fields as you want. This option is required when you clone a test suite to a different project.
/destinationsuiteid:`id`	Specifies the ID of the suite into which the new copy will be added. If you want to copy a whole test plan, use the ID of the suite at the root of the test plan. The ID of a suite is displayed in the details pane when you select it in the test plan. You can also get a list of suites by using `tcm suites /list`.
/destinationteamproject:`projectname`	Optional. Specify when you want to clone the test suite to a different project but in the same organization or project collection. When specified, you must specify override field values for the Area Path and Iteration Path fields.
/destinationworkitemtype:`workitemtype`	Optional. Specify when you want to clone the test suite to a different work item type in the destination project.
/clonerequirements	Optional. Specify this switch to clone a requirement-based suite to a destination requirement-based suite. By default, a requirement-based test suite is cloned to a destination static test suite.

[!INCLUDE prerequisites-define]

Understand what gets cloned

When you clone a test suite, the following objects are copied from the source test plan to the destination test plan.

Test plan object	Notes
Test case	Each new test case retains its shared steps. A link is defined between the source and new test cases. The new test cases do not have test runs, bugs, test results, or build information.
Shared steps	Shared steps referenced by cloned test cases are copied.
Test suite	Test suites that are copied retain the following data: <br<br- Names and hierarchical structure of the test suites<br- Order of the test cases<br- Assigned testers<br- Configurations
Recordings	Action recordings linked from a cloned test case are copied.
Links and Attachments	All links and attachments are copied for all copied test items.
Test configuration	The test configuration defined for the source test plan is copied over and applied to the destination test plan.

The following test information is not copied:

Test settings: The test setting for the source test plan isn't copied. Instead, the test settings for the destination test plan are applied.
Test results and test runs: No test results are copied. Because test runs are applicable only to the source test plan, they are not copied.

When /clonerequirements is specified and Requirements-based test suites are copied:

The Requirements-based test suites are copied and linked to a new copy of the requirement work item.
Requirements work items (product backlog items or user stories) that are associated with a cloned requirements-based suite are cloned.
Bug work items are cloned in a project that uses the Scrum process template, or any project in which the Bug work item type is in the Requirements work item category. Otherwise, bugs aren't cloned.

When /clonerequirements in't specified and Requirements-based test suites are copied:

Requirements-based test suites are converted to static test suites in the destination test plan.
Cloned test cases are referenced under the static test suite.
Cloned test cases don't include links to their original requirements work items.

Example

The following example illustrates cloning test suite 97 defined for the Fabrikam Fiber project to the Fabrikam Git project. Because the test suite contained a query-based suite, a warning message is listed to review and revise the respective query in the source and destination test suites.

tcm suites /clone /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber" /destinationteamproject:"Fabrikam Git" /suiteid:97 /destinationsuiteid:104 /overridefield:"Iteration Path"="Fabrikam Git" /overridefield:"Area Path"="Fabrikam Git"

Started clone operation with id 4.
Use /status:4 to get progress and completion information of the operation.
Warning: You have cloned the following query based suites as part of this clone operation. You are advised to fix their respective queries in the source and destination suites, after the clone operation completes.
1. Sprint 3 -> Sprint 3 query-based suite

Track the status of the test suite clone operation

Use tcm suites /clone /status to retrieve the status of the clone operation made with tcm suites /clone. Test suites that contain a large number of test cases can take a considerable time to clone.

tcm suites /clone
           /status:cloneoperationid
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]]

Parameter	Description
/status:`cloneoperationid`	Required. Specifies the ID of the clone operation returned when `tcm suites /clone` executes.

[!INCLUDE prerequisites-define]

Example

tcm suites /clone /status:4 /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"

Clone operation 4 has succeeded. Summary information:
Started on:           10-Nov-21 5:00:28 PM
Started by:           Jamal Hartnett
Source suite id:      97
Destination suite id: 114
Test cases cloned:    9
Shared steps cloned:  0
Requirements cloned:  0
Completed on:         10-Nov-21 5:00:30 PM

::: moniker range=">= azure-devops-2020"

Copy test case(s)

From the web portal, you can copy test cases from within a project or another project to a test suite, or you can use the Grid view to copy and paste test cases from one suite to another. Optionally, you can bulk import and export test cases.

Tip

Don't copy test cases when what you really want to do is test with different configurations or different data.

You can copy test cases from within a project or another project in the organization or collection to a designated test plan and test suite. At the same time, you can optionally copy all links and attachments.

Open Test Plans>Test plans, choose the Test Plan that contains the test case(s) you want to copy from the Mine or All page. Next, choose the Test Suite that contains the test case(s) you want to copy. From the Define page, select the check box for all test cases you want to copy.
Choose :::image type="icon" source="../media/icons/more-actions.png" border="false"::: More actions, and choose the Copy test case menu option.

:::image type="content" source="media/copy-clone/copy-test-cases-menu-selection.png" alt-text="Test Cases More Actions menu, copy test cases option.":::
From the Copy test case(s) dialog, choose the Project if copying test cases from a different project. Next, select the test plan and test suite to copy the test cases to.

:::image type="content" source="media/copy-clone/copy-test-cases-dialog.png" alt-text="Copy test cases dialog":::

Optionally select the check boxes for Include existing links and Include existing attachments. When done, choose Create.

Depending on the number and complexity of the test cases selected, the copy operation will be performed in the background. Once completed, you'll receive a message that the operation has completed and a link to the test suite where the test cases have been copied to.

::: moniker-end

Copy and paste test case(s) (Grid view)

You copy and paste test cases in order to use the same tests in different suites and plans. For example, you could have a test suite that uses a subset of the tests defined in a more exhaustive test suite. The Define>Grid view supports editing test cases as well as copy and pasting test cases to different test suites. For editing test cases, see Create test cases, Use the Grid view to edit test cases.

Tip

Don't copy test cases when what you really want to do is test with different configurations or different data.

From the Internet Explorer, Edge, or Chrome browsers, you can copy test cases from the Grid view for one test plan and test suite to another test plan and test suite.

From the Test Plans>Test plans page, choose the test suite containing the test case(s) you want to copy. Within the Define tab, Choose the Grid view.
Highlight the rows you want to copy, and then enter CTRL+C.

:::image type="content" source="media/copy-clone/copy-paste-test-cases.png" alt-text="Copy test cases from Grid view.":::
Select a different test suite from the same or different plan and paste with CTRL+V. If you don't select a different suite, nothing happens when you paste, because each suite can only have one reference to any test case.
Choose :::image type="icon" source="media/icons/save-test-cases.png" border="false"::: Save test cases.

The new test cases are saved with new IDs assigned.

:::image type="content" source="media/copy-clone/copy-paste-test-cases-saved.png" alt-text="Saved test cases pasted into Grid view.":::

::: moniker range=">= azure-devops-2020"

Bulk import or export test cases

From the web portal, you can perform a bulk import or export of test cases from/to a test suite. Test cases are defined in a comma-separated values (CSV) file.

Export test cases

From the Test Plans>Test plans page, choose the test plan with the test suite containing the test cases you want to export.
Optional. Choose :::image type="icon" source="media/icons/column-options.png" border="false"::: Column options to add fields to include in the download file.
To export all test cases for the test suite, choose Export test cases to CSV.

:::image type="content" source="media/copy-clone/export-test-cases-test-suite.png" alt-text="Screenshot of Export test cases from the selected test suite.":::

To export a subset of test cases for the test suite, select the test cases to export, choose :::image type="icon" source="../media/icons/more-actions.png" border="false"::: More options, and select Export test case(s) to CSV.

:::image type="content" source="media/copy-clone/export-select-test-cases-test-suite.png" alt-text="Screenshot of selected test cases, Export test cases to CSV.":::
The exported CSV file appears in your Downloads folder.

Import test cases

From Test Plans>Test plans page, choose the test plan with the test suite into which you want to import test cases.

:::image type="content" source="media/copy-clone/choose-import-test-cases.png" alt-text="Screenshot of Import test cases to the selected test suite.":::
Choose the file to import from the dialog that opens, and then choose Import.

:::image type="content" source="media/copy-clone/import-test-cases-dialog.png" alt-text="Import Test Cases dialog.":::
Choose Confirm in the Confirm import dialog that displays. If you specify test cases that are already defined in the test suite, some elements may get over written during import.

::: moniker-end

Import automated test cases (TCM)

To import automated test cases to a test suite, use tcm testcase /import. You must specify a .dll file for the test assembly that contains your tests.

tcm testcase /import /collection:teamprojectcollectionurl /teamproject:project
             /storage:path
             [/maxpriority:priority]
             [/minpriority:priority]
             [/category:filter]
             [/syncsuite:id [/include]]
             [/login:username,[password]]

Parameter	Description
/storage:`path`	Specifies the path and name of the test assembly that contains your automated tests that you want to import.
/maxpriority:`priority`	Optional. Specifies which tests to import based on the maximum priority of the test method. For example, if the parameter is `/maxpriority:1`, only tests with a priority attribute for the test method less than or equal to 1 are imported as test cases from the assembly.
/minpriority:`priority`	Optional. Specifies which tests to import based on the minimum priority of the test method. For example, if the parameter is `/minpriority:2`, only tests with a priority attribute for the test method equal or greater than 2 are imported as test cases from the assembly.
/category:`filter`	Optional. Specifies which tests to import based on the category of each test method in the test assembly. You can use this parameter together with `/syncsuite` to import tests with a certain category into a specific test suite. For more information about test categories, see Run unit tests with Test Explorer.
/syncsuite:`id`	Optional. Specifies the suite ID for the test suite in your test plan to which you want to add the test cases that you import. This suite cannot be a dynamic suite or a query-based suite. If you specify a test suite to synchronize to update tests that have already been added, the tests that aren't imported are removed from the test suite but not from the test plan itself.

[!INCLUDE prerequisites-define]

[!INCLUDE limitations-import]

Next step

[!div class="nextstepaction"] Run manual tests

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

copy-clone-test-items.md

copy-clone-test-items.md

Copy or clone test plans, test suites, and test cases

Supported copy, clone, and import tools

:::row::: :::column span="1"::: Client/tool
:::column-end::: :::column span="1"::: Test Plans :::column-end::: :::column span="1"::: Test Suites :::column-end::: :::column span="1"::: Test Cases :::column-end::: :::row-end:::

List test plans or test suites

Browser

TCM CLI

List test plans

List test suites

Copy or clone test plans

Browser

TCM CLI

Clone a test plan

Track the status of the test plan clone operation

Import or clone test suites

Browser

TCM CLI

Clone a test suite

Track the status of the test suite clone operation

Copy test case(s)

Copy and paste test case(s) (Grid view)

Bulk import or export test cases

Export test cases

Import test cases

Import automated test cases (TCM)

Next step

Related articles

Microsoft Test Manager (deprecated)

REST APIs

Files

copy-clone-test-items.md

Latest commit

History

copy-clone-test-items.md

File metadata and controls

Copy or clone test plans, test suites, and test cases

Supported copy, clone, and import tools

:::row::: :::column span="1"::: Client/tool :::column-end::: :::column span="1"::: Test Plans :::column-end::: :::column span="1"::: Test Suites :::column-end::: :::column span="1"::: Test Cases :::column-end::: :::row-end:::

List test plans or test suites

Browser

TCM CLI

List test plans

List test suites

Copy or clone test plans

Browser

TCM CLI

Clone a test plan

Track the status of the test plan clone operation

Import or clone test suites

Browser

TCM CLI

Clone a test suite

Track the status of the test suite clone operation

Copy test case(s)

Copy and paste test case(s) (Grid view)

Bulk import or export test cases

Export test cases

Import test cases

Import automated test cases (TCM)

Next step

Related articles

Microsoft Test Manager (deprecated)

REST APIs

:::row::: :::column span="1"::: Client/tool
:::column-end::: :::column span="1"::: Test Plans :::column-end::: :::column span="1"::: Test Suites :::column-end::: :::column span="1"::: Test Cases :::column-end::: :::row-end:::