Test Manager user guide

DELIVERY:

Last updated Aug 25, 2025

Export project

You can export projects from Test Manager to a file to allow you to recreate the project later. Use this feature to:

Transfer entire testing projects to different tenants or instances of Test Manager.
Create backup copies of any of your projects.

How it works

Exporting a project generates a TMH file that can be then imported in another Test Manager instance. This includes objects such as requirements, test cases, test sets, labels, custom fields, attachments, and automation information. The export process is done asynchronously, notifying when the export process is finished.

Note: Users with a valid Test Manager license can export projects. For more information, check User and Group Access Management.

Considerations

The export TMH file contains:

Exported objects	Details
Test objects	When you export a project, you can choose the export TMH file to contain one or all of the following: Requirements Preconditions Test cases Postconditions Test sets (and their corresponding labels) Object labels Attachments Custom field values (definitions are not exported) Automation information for test cases, including linkage between a test case and an Orchestrator automation Test results (available only if you export test cases) Defects (available only if you export test results, exports only references)
Assignments between objects	Assignments between requirements and test cases Static assignments between test cases and test sets Since dynamic assignments to test sets are only resolved at the time of execution, dynamically assigned test cases are not exported along with the test sets. Assignments between test objects and labels
Project information	Name Prefix Description

Prerequisites

To make sure that the export TMH file downloads successfully, set the

buffer
                     response

setting in your API Management Gateway as false:

Access your API Management Gateway system.
Locate the API endpoints that finish with /download. You want to set the buffer response to False only for API endpoints that have download as the API response.
Check out the official documentation for your API Management Gateway system. For example, if you use Microsoft Azure, check out the official documentation, to learn how to change the buffer-response setting from true to false.

Exporting a project from Test Manager - Standalone

Enable email notifications for your Test Manager instance:

Select More Options in the Test Manager header > Application Settings.
Inside the Email tab select Enable email notifications.
Configure the values for the email notification event:
1. Host (Required) - The SMTP server address (for example, smtp-mail.outlook.com).
2. Port (Required) - The port of the SMTP server.
3. Username - The username that you use for server authentication.
4. Password - The password associated with the username that you use for server authentication.
5. Domain - The domain of Username.
6. From Address (Required) - The email address to send the emails from.
7. From Display Name (Required) - The display name of the sender.
Select Save.

To export an existing project in Test Manager:

Sign in to Test Manager. Choose the project you want to export, and select More Options. The Export Project panel opens.
Warning: Test Results aren't included in the export file.
Select the test objects that you want to include in the export file, and then select Export.
Wait for the export process to finish and open the Project Export Completed notification that you receive via email.
Select Download. You are redirected to the Test Manager instance from where you exported, and the export TMH file downloads automatically. In case the download doesn't start automatically, select Download.
Note: If you have not enabled email notifications for your Test Manager instance, you can search for your exported TMH file in the local folder where Test Manager is installed. Follow these steps to find the TMH file:
1. Open the Test Manager local folder.
2. Go to the Storage folder.
3. Open the folder that begins with TMH, followed by a specific tenant ID.
  This folder stores all attachments found in that particular tenant.
4. Navigate to the User folder, and then the Project folder.
5. Open the file titled with the ID of your desired project.
  You can get the ID of your project using the Test Manager APIs.
6. In the Export folder you can find all the exported TMH files. The complete path would look like this: ...\UiPath TestManager/Storage/TMH-<tenantID>/User/Project/<projectID>/Export.