UiPath Documentation
test-cloud
latest
false

Test Cloud admin guide

Test Cloud quickstart

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:

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 optionWhat it means
Automation CloudUiPath's managed SaaS platform. Test Cloud lives here. Always select this option when reading Test Cloud docs.
Automation SuiteUiPath's on-premises or private cloud deployment. Test Cloud is not available on Automation Suite.

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

Step 1 — Start your Test Cloud trial​

Important:

Test Cloud licenses are exclusively available under the Unified Pricing Plan (P2.0). There is no self-service purchase or self-service trial sign-up — all trials and paid plans are provisioned through UiPath Sales.

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.

To request a trial:

  1. Navigate to https://www.uipath.com/platform/agentic-testing.
  2. Select Sign up for Test Cloud.
  3. A UiPath Account Executive will reach out to set up your trial organization and send you your credentials or license code.

Once your organization is provisioned, use Path B — Activate a license code in Step 2 to complete activation, or sign in directly if your AE has already activated the organization on your behalf.

After your organization is provisioned​

Once your Account Executive has set up your trial organization and you have signed in for the first time, complete these steps before inviting teammates:

  1. Go to Admin > <Your Tenant> > Services, then confirm that Orchestrator and Test Manager are enabled.
  2. Go to Admin > Licenses > Users and assign yourself an App Test Developer - Named User or App Tester - Named User license. This is required to access the Test Cloud interface.
  3. Invite teammates by creating user accounts under Admin > Accounts & Groups > Users and assigning them the appropriate licenses.

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​

Application Testing Standard and Enterprise plans are not available for self-service online purchase. All plans are sold through UiPath Sales.

To convert your trial to a paid plan, choose one of the following:

  • Via the UiPath website: Navigate to https://www.uipath.com/platform/agentic-testing, select Contact Sales, and submit your request. A UiPath Account Executive will follow up to finalize your plan and quantities.
  • Via your Account Executive directly: If you already have an AE assigned, contact them to discuss plan options, quantities, and pricing.

Once your order is processed, you receive a license code. Use Path B — Activate a license code to apply it to your organization.

Path B — UiPath provided you with a license code​

Use this path if your account team or Technical Account Manager sent you an Enterprise license code.

  1. Sign in to Test Cloud as an organization administrator.
  2. Go to Admin > Licenses.
  3. Select Enterprise Activation in the top right.
  4. Paste your 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:

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

You are switching your existing organization from the Flex Pricing Plan to the Unified Pricing Plan. You do not need to set up a new organization or migrate any data.

Warning:

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 currently in your organization:

Flex Pricing Plan — Test SuiteUnified Pricing Plan — Test Cloud
UiPath - Flex - Automation DeveloperUiPath - Uni - App Test Developer
UiPath - Flex - Tester UserUiPath - Uni - App Tester
UiPath - Flex - Unattended Test RobotUiPath - Uni - App Test Robot
UiPath - Flex - Test ManagementUiPath - Uni - App Test Platform
UiPath - Flex - InsightsUiPath - Uni - App Test Platform
UiPath - Flex - Insights DesignerUiPath - Uni - App Test Platform
UiPath - Flex - SAP Transport UnitsUiPath - Uni - SAP Transport Units
UiPath - Flex - AI Units / Agent Units / Cloud Robot UnitsUiPath - 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 WebStudio Desktop
InstallationNone — runs in the browserRequired (Windows, v2025.10+)
Best forGetting started quickly; cross-browser and macOS app testingComplex automations, coded tests, data-driven testing
AccessIncluded with the App Test Developer licenseDownload from uipath.com/product/studio
How to startFrom Test Manager — test case → Automation tab → Automate in Studio WebInstall, 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:

  1. In Test Manager, open a test case and select the Automation tab.
  2. Select Automate in Studio Web. A configuration panel opens on the right.
  3. From the Project dropdown, select an existing Studio Web Tests project or enter a new name to create one.
  4. From the Test case dropdown, select an existing test case or enter a new name.
  5. Select Add automation. Your test case is now linked to Studio Web.
  6. Select Open in Studio Web. Studio Web opens in a new browser tab with your test case ready to edit.
  7. Design your test case using activities from supported packages, such as Testing.Activities.
  8. 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.

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.

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.

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.
  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 Save.
  6. On the machine template card, copy the Machine Key — you will need this when registering the robot.

Install and register the Robot​

  1. On the machine where tests will run, download the UiPath Robot from the UiPath Robot product page or from Resources > Robot within Orchestrator.
  2. Run the installer and complete the installation.
  3. Open the UiPath Assistant (or Robot tray) and navigate to Orchestrator Settings (the gear icon).
  4. Set the connection type to Machine Key.
  5. Enter your Orchestrator URL in the format: https://cloud.uipath.com/<org-name>/<tenant-name>/orchestrator_
  6. Paste the Machine Key copied in the previous section.
  7. Select Connect.

For the full Robot installation and configuration guide, refer to the UiPath Robot documentation.

Verify the connection​

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

Your robot is ready to execute tests. You can now create a test set in Test Manager and select Execute Automated to run your first automated execution.

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​

GoalResource
Create your first test project in Test ManagerTest Manager quickstart guide
Automate test cases in Studio WebAutomating test cases in Studio Web
Build test cases in Studio DesktopStudio testing capabilities
Explore the complete Test Cloud toolsetTesting tools
Invite users and configure accessManaging accounts and groups
Set up SSO for your organizationAuthentication settings
Understand what's included in each planUnified Pricing: Licensing plan framework
Full Flex-to-Unified migration guide (assets, pipelines, test cases)Migrate from Test Suite to Test Cloud

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated