Test Cloud quickstart

Complete the onboarding journey for Test Cloud by starting a trial, activating a license, installing Studio, and setting up App Testing robots.

This guide walks you through the complete onboarding journey for Test Cloud: starting a trial, activating your license, installing Studio, and setting up App Testing robots. By the end, your environment is ready to run automated tests.

Tip:

Coming from Automation Cloud Testing — Flex (Test Suite)?

You do not need to create a new organization or request a new trial. Skip directly to Path C — Migrate from Flex to Unified Pricing in Step 2.

Understanding the docs delivery dropdown

When browsing UiPath documentation, you will see a Delivery dropdown showing options such as Automation Cloud and Automation Suite. This controls which deployment platform the docs describe — not which product you are reading about.

Delivery option	What it means
Automation Cloud	UiPath's managed SaaS platform. Test Cloud lives here. Select this option when reading Test Cloud docs.
Automation Suite	UiPath's on-premises or private cloud deployment. Test Cloud is also available here, named Private Test Cloud. Select this option when reading Private Test Cloud docs.

If you are setting up Test Cloud on Automation Cloud, select Automation Cloud in the delivery dropdown. If you are setting up Private Test Cloud on Automation Suite, select Automation Suite instead. Pages that appear to overlap are describing the same product feature on two different deployment platforms.

---

Step 1 — Start your Test Cloud trial

The trial uses the Application Testing Standard Trial plan and runs for 60 days. It includes two App Test Developer licenses, two App Tester licenses, two App Testing Robot runtimes, and 3,000 Platform Units.

Test Cloud trial sign-up is self-service and does not require assistance from a UiPath Account Executive.

To start a trial:

1. Open the Test Cloud trial page.
2. Select Try Test Cloud.
3. Sign up using a business email account.
4. Follow the prompts to create your Test Cloud organization.

After you create your organization

After you create your trial organization and sign in for the first time, verify the services and trial licenses before inviting teammates:

1. Go to Admin > <Your Tenant> > Services. Verify that Orchestrator and Test Manager are listed and enabled. If a service is not listed, select Add Services, select the service, and select Add. If a listed service is disabled, select its More icon and then select Enable.
2. Go to Admin > Licenses > Users and verify that your account has an App Test Developer - Named User or App Tester - Named User license. Trial licenses can be allocated automatically to the account that created the organization, so a separate save action might not be required. If User License Management is enabled and neither license is listed, select Allocate Licenses, select your account, choose the appropriate license, and select Save. If User License Management is disabled, user licenses are assigned at the tenant level rather than directly to user accounts. For more information, see User License Management and Allocating licenses to tenants.
3. Invite teammates by creating user accounts under Admin > Accounts & Groups > Users and assigning them the appropriate licenses.

Note:

The Services page shows whether a service is enabled; you do not need to repeat the setup if Orchestrator and Test Manager are already enabled. The Licenses page shows whether the trial allocation is already linked to your account.

---

Step 2 — Activate your license

Choose the path that matches your situation.

Path A — You are on a trial and want to purchase a plan

Online purchase is available for non-enterprise licensing plans only. Enterprise plans and license types that are not available on the purchase page require assistance from UiPath Sales.

To convert your trial to a paid plan, choose the path that matches your plan:

• Non-enterprise plan available online: Open the Pricing page and follow the purchase flow. Online purchase provides immediate access to the purchased resources.
• Enterprise plan or license type unavailable online: Open the Agentic testing page and select Request a demo. Complete the contact sales form with your organization and plan requirements. After your order is processed, use Path B — Activate a license code to apply the license code to your organization.
• Via your Account Executive directly: If you already have an AE assigned, contact them to discuss plan options, quantities, and pricing. After your order is processed, use Path B — Activate a license code if your account team provides a license code.

Path B — UiPath provided you with a license code

Use this path only when your account team or Technical Account Manager sent you an Enterprise license code. Do not look for the code in the Test Cloud interface. If the Licenses page already shows the Enterprise label and your available license inventory, the license is already active and you can continue to Step 3.

1. Sign in to Test Cloud as an organization administrator.
2. Go to Admin > Licenses.
3. Select Enterprise Activation in the top right.
4. Enter the license code in the License Code field.
5. Select Activate.

The Licenses page updates to show the Enterprise label next to the page title and displays your available license inventory.

After activation:

• Allocate robot and service licenses to tenants
• Assign user licenses to users or groups

Path C — Coming from Automation Cloud Testing — Flex (Test Suite)

Use this path only if you are moving an existing organization from the Flex Pricing Plan to the Unified Pricing Plan. If you are starting with Test Cloud and are not migrating from Test Suite, skip this path and continue to Step 3. You do not need to set up a new organization or migrate any data.

Warning:

Important: read before you start

The switch from Flex to Unified Pricing is immediate and cannot be partial. Flex licenses are deallocated and Unified licenses are allocated at the same time — both cannot be active in the same organization simultaneously.

• Users lose access the moment the switch completes if you do not reassign them to Unified licenses right away.
• Robots keep running on their existing Flex license until you manually reassign them, so scheduled test executions are not interrupted.

License mapping

Use this table to identify the correct Unified Pricing license for each Flex license in your organization:

Flex Pricing Plan — Test Suite	Unified Pricing Plan — Test Cloud
Users
UiPath - Flex - Automation Developer	UiPath - Uni - App Test Developer
UiPath - Flex - Tester User	UiPath - Uni - App Tester
Robots
UiPath - Flex - Unattended Test Robot	UiPath - Uni - App Test Robot
Platform
UiPath - Flex - Test Management	UiPath - Uni - App Test Platform
UiPath - Flex - Insights	UiPath - Uni - App Test Platform
UiPath - Flex - Insights Designer	UiPath - Uni - App Test Platform
Consumables
UiPath - Flex - SAP Transport Units	UiPath - Uni - SAP Transport Units
No equivalent in Flex Pricing Plan	UiPath - Uni - Test Execution Units
UiPath - Flex - AI Units	UiPath - Uni - Platform Units
UiPath - Flex - Agent Units	UiPath - Uni - Platform Units
UiPath - Cloud - Robot Units	UiPath - Uni - Platform Units

1. Run the License Migration wizard

1. Sign in to Test Cloud as an organization administrator.
2. Go to Admin > Licenses and select License Migration in the top right.
3. Select Start Migration for the first license type in the list.
4. In the migration view, select the target Unified license from the dropdown, then review the listed users and groups.
5. Select Apply Migration.
6. Repeat for each remaining Flex license type.

2. Reassign user licenses — do this immediately

1. Go to Admin > Licenses > Users.
2. For individual users: Select Edit license allocation and assign App Test Developer - Named User or App Tester - Named User.
3. For user groups: Select Edit group allocation rule and assign the appropriate Unified license.

The change takes effect on save. Named-user licenses apply organization-wide — no per-tenant allocation is required.

Note:

You must enable User License Management to view and manage user licenses under Unified Pricing. If user licenses are not visible after the switch, go to Admin > Licenses > Settings and enable User License Management.

3. Reassign robot licenses per tenant

1. Go to Admin > <Your Tenant> > Licenses, select Edit allocation, and enter the number of App Test Robot runtimes for that tenant.
2. Open Orchestrator and navigate to Tenant > Machines.
3. For each machine template, select Edit, set the runtime type to App Testing, and enter the desired concurrency count.
4. Select Update to save.

4. Confirm the App Test Platform license

The App Test Platform license is an organization-level license — no tenant allocation is needed. Once it is active, Test Manager and Insights become available in all tenants automatically.

If Test Manager is not yet visible in a tenant after the switch:

1. Go to Admin > <Your Tenant> > Services.
2. Select Add Services, choose Test Manager, and confirm.

5. Allocate consumables per tenant (if needed)

SAP Transport Units draw from a single organization-wide pool — no per-tenant allocation is required.

For Test Execution Units and Platform Units:

1. Go to Admin > <Your Tenant> > Licenses > Consumables.
2. Select Edit allocation and set the budget for Test Execution Units and Platform Units for that tenant.

For the full migration checklist — covering assets, test case artifacts, CI/CD pipelines, and validation steps — see Migrate from Test Suite to Test Cloud.

---

Step 3 — Set up your test authoring tool

Test Cloud supports two authoring tools. You can use either or both depending on your team's needs.

	Studio Web	Studio Desktop
Installation	None — runs in the browser	Required (Windows, v2025.10+)
Best for	Getting started quickly; cross-browser and macOS app testing	Complex automations, coded tests, data-driven testing
Access	Included with the App Test Developer license	Download from uipath.com/product/studio
How to start	From Test Manager — test case → Automation tab → Automate in Studio Web	Install, connect to your Test Cloud org, publish packages to Orchestrator

Option A — Studio Web (no installation required)

Studio Web is a cloud-native, browser-based IDE built into Test Cloud. It requires no installation and works on Windows and macOS. It supports cross-browser web testing and native macOS application testing.

Studio Web Tests projects are always initiated from Test Manager — you cannot create them directly in Studio Web.

To create your first test automation in Studio Web, create the Test Manager project and test case before opening the automation options:

1. Sign in to Test Manager and select Create new project on the Home page.
2. Enter a project name and the required project prefix, then select Create.
3. Open the project you created.
4. In the left navigation, select Test Cases.
5. Select Create Test Case, enter the test case details, and select Confirm.
6. Open the new test case and select the Automation tab. The Automate in Studio Web option is available only after a project and test case exist.
7. Select Automate in Studio Web. A configuration panel opens on the right.
8. From the Project dropdown, select an existing Studio Web Tests project or enter a new name to create one.
9. From the Test case dropdown, select an existing test case or enter a new name.
10. Select Add automation. Your test case is now linked to Studio Web.
11. Select Open in Studio Web. Studio Web opens in a new browser tab with your test case ready to edit.
12. Design your test case using activities from supported packages, such as Testing.Activities.
13. When ready, publish the project to Orchestrator by selecting Publish in Studio Web.

Note:

Only App Test Developer users have access to Studio Web for authoring. App Tester users can execute and review tests but cannot create or edit automations in Studio Web.

For the full Studio Web testing guide, refer to About tests and Automating test cases in Studio Web.

Option B — Studio Desktop

Use Studio Desktop for more advanced scenarios: coded automations, data-driven tests, complex workflow logic, and projects that exceed the scope of what Studio Web supports.

For application testing, use Studio version 2025.10 or later. For full system requirements and compatibility, refer to the technical compatibility matrix and Studio hardware and software requirements.

Install Studio Desktop

1. Navigate to https://www.uipath.com/product/studio and select Download Studio.
2. Run the downloaded installer.
3. In the setup wizard, select Studio as the profile.
4. Accept the license agreement and complete the installation.

Connect Studio Desktop to your Test Cloud organization

1. Open Studio and go to Home > Orchestrator Settings.
2. Set the connection type to Cloud.
3. Select Sign In and authenticate with your Test Cloud credentials.
4. Select your Organization and Tenant from the dropdowns.
5. Select Connect.

Studio is now connected to your Test Cloud organization. Test packages you publish from Studio go to your Orchestrator tenant, where Test Manager can link them to test cases for execution.

Note:

If Orchestrator Settings is not visible on the Home page, go to Tools > Orchestrator Settings from the top menu bar.

---

Step 4 — Set up App Testing robots

App Testing robots run your automated test cases on target machines. Each robot connects to Orchestrator, picks up jobs triggered by Test Manager, and executes the test packages published from Studio.

This procedure uses a Robot installed on a customer-managed Windows machine. It does not use Cloud Robots - VM, which provisions a UiPath-managed virtual machine and follows a different procedure. For that managed-VM option, see Running unattended automations using Cloud Robots - VM.

Before you start

• Confirm that App Test Robot runtimes are allocated to your tenant (completed in Step 2).
• Prepare a Windows machine where tests will run. The machine needs outbound HTTPS access to your Test Cloud tenant.
• Confirm that your user account and the Robot account can access the Orchestrator execution folder you plan to use in Test Manager.

Create a machine template in Orchestrator

1. Open Orchestrator from your Test Cloud tenant.
2. Navigate to Tenant > Machines and select Add Machine > Standard Machine Template. Do not select Cloud Robots - VM for this procedure.
3. Enter a name for the template.
4. Under Runtime licenses, set App Testing to the number of concurrent test executions you want to support.
5. Select Provision. If the Standard Machine Template page displays Save instead, select Save and wait for the template to be created.
6. Open the resulting machine template card. The Machine Key appears after the template is created or provisioned. Copy the key for the Robot registration step.

Install and register the Robot

1. On the Windows machine where tests will run, download the UiPathRobot.msi installer from the Resource Center in your cloud platform or from Product Downloads.
2. Run UiPathRobot.msi and complete the installation. This is the installer for the Robot that runs tests on your Windows machine; it is not the Cloud Robots - VM provisioning option.
3. Open UiPath Assistant and navigate to Orchestrator settings.
4. Ask your Orchestrator administrator which unattended Robot authentication method is enabled under Tenant > Settings > Robot security, then choose the corresponding connection type:
   • If Machine Key authentication is enabled, select Machine Key.
   • If client-credential authentication is enabled, select Client ID.
5. If you selected Machine Key, enter https://cloud.uipath.com/<org-name>/<tenant-name>/orchestrator_ in the Orchestrator URL field, then enter the key copied from the machine template card in the Machine Key field. Enter only the URL shown, without a trailing period or other punctuation.
6. If you selected Client ID, enter the full Orchestrator URL, the Client ID, and the Client Secret generated by the machine template.
7. Select Connect.

For the full Robot installation guide, refer to Installing on Windows OS. For connection details, see Connecting unattended Robots to Orchestrator.

Configure the execution folder in Test Manager

The execution folder is selected in Test Manager when you configure a test set. It is not selected in the Standard Machine Template, and selecting Cloud Robots - VM does not resolve folder-access issues.

Before configuring a specific execution folder and Robot account, ask an administrator to confirm that Allow legacy execution context is disabled for the tenant. Specific folder and Robot selection requires this setting to be turned off. For more information, see Tenant-level settings.

1. In Test Manager, open Test Sets and open the test set you want to run.
2. Go to the Test Cases tab and select Configure Automation.
3. From the Execution folder dropdown, choose a folder that both your user account and the Robot account can access. The folder selection populates the Select Robot dropdown.
4. From Select Robot, choose the registered Robot account or Any User/Robot account, then select Save.

Note:

If Shared is not listed or you cannot select a folder, the folder is not available to your account or tenant. Select None to use the tenant's Default folder if one is configured. Otherwise, ask an administrator to assign both the Robot account and the machine template to the same execution folder and grant your account access to that folder. For more information, see Configuring test sets for specific execution folders and robots.

Verify the connection

1. In Orchestrator, go to Monitoring > Robots.
2. Confirm your Robot appears with Available status.

Result

The Robot is connected to Orchestrator, and Test Manager can use the selected execution folder and Robot account for automated test execution. You can now select Execute Automated for a configured test set.

Note:

App Testing robots are licensed for non-production environments only. For details on license types and permitted use cases, refer to Test robots.

---

Next steps

Goal	Resource
Create your first test project in Test Manager	Test Manager quickstart guide
Automate test cases in Studio Web	Automating test cases in Studio Web
Build test cases in Studio Desktop	Studio testing capabilities
Explore the complete Test Cloud toolset	Testing tools
Invite users and configure access	Managing accounts and groups
Set up SSO for your organization	Authentication settings
Understand what's included in each plan	Unified Pricing: Licensing plan framework
Full Flex-to-Unified migration guide (assets, pipelines, test cases)	Migrate from Test Suite to Test Cloud