- Getting started
- Data security and compliance
- Organizations
- Authentication and security
- Licensing
- Tenants and services
- Accounts and roles
- AI Trust Layer
- External applications
- Notifications
- Logging
- Troubleshooting
- Migrating to Automation Cloud™
Managing tenants
This feature is not available on the Community or Free licensing plans. These organizations are limited to one tenant, which is created automatically.
For Pro Trial users, all tenants are created in the region where the organization data resides.
For Pro and Enterprise customers, if you need it to be in a different region, you can create a new tenant in your preferred region.
To create a new tenant:
The new tenant is added to the Tenants panel on the left.
The loading icon is displayed while tenant provisioning is in progress.
After the icon disappears:
- The tenant and its services are ready for use.
- The tenant is available to users from the tenant picker in the top right of the page, but they only have read-only access.
Next steps: To be able to work in the tenant, you or a service administrator must assign roles and licenses for the services in the new tenant to users. For more information, see:
Enterprise customers can choose the region of tenants when creating them. However, after creating the tenant you cannot change the region yourself.
If you need to move a tenant to a different region, open an SLA ticket and request the move to one of the available regions.
You can add a canary tenant to your organization to view and test upcoming changes before they reach your other tenants. The canary tenant serves as an isolated medium that uses your current setup where you can check on the impact that upcoming changes have within the context of your current organization.
With a canary tenant, you can:
- view and test enterprise-only features before they reach enterprise environments
- test and run the same automations that you use in production.
-
Do not use the canary tenant for production.
-
This feature is a medium made available to you for testing purposes only and does not benefit from the same enterprise commitments as your other tenants.
-
The uptime guarantee offered by your enterprise plan does not apply to the canary tenant.
-
While we encourage reporting any potential issues you encounter within the canary tenant, please note that we will address them on a best-effort basis only.
Early access window
The canary tenant receives updates to enterprise functionality for all of the supported services as soon as they are announced in the release notes, while your other tenants receive them at least 3 days later.
Included services
Only the following UiPath® cloud services are available to be provisioned in a canary tenant:
Service name |
Notes |
Release notes |
---|---|---|
Orchestrator |
Data retention for Orchestrator within the canary tenant is reduced to the thresholds for community plans. |
If a service is not listed in the above table, then it does not receive early updates in the canary tenant.
Data residency
The canary tenant and its service data is always hosted in the European Union (Europe) region and you cannot choose a different region.
Tips
To make the most of your canary tenant, we recommend setting it up in the same way as your production tenants. This includes replicating the same:
- tenant settings in UiPath Orchestrator
- service-level settings for each of the services you provisioned in the canary tenant
- service-level roles and user licenses for your users
- automations in Orchestrator - You can use the UiPath Orchestrator Manager to copy data from one of your tenants to the canary tenant.
When editing tenant settings, you can change the name, color, enable, disable, or delete the tenant.
A confirmation message appears in the top right of the screen.
Impact of changing tenant names
Changing the name of any of your tenants greatly impacts your previous UiPath service configurations:
- Robots configured at Orchestrator services level are disconnected. Reconnect your robots, entering the new URLs.
- Service URLs previously bookmarked don't work anymore. Send your users the new URLs.
- Mobile Orchestrator users are disconnected. Send them the new service URLs to connect again.
- User invites sent before the change are not valid anymore. Send new invites for your colleagues who haven’t joined yet.
Disabled tenants remain visible to organization administrators in the Tenants panel of the Admin page, but the tenant and its services are no longer available to users. Also, the licenses that were allocated to the tenant are released and returned to the organization's pool of licenses.
All data for the services is kept. You can later enable the tenant to access its services again.
A loading icon is shown next to the tenant in the Tenants panel on the left while the change is being processed.
After the icon disappears:
- If you disabled the tenant, Disabled appears to its right and the tenant and its services are no longer available to users.
- If you enabled the tenant, it is now restored as it was before being disabled. All licenses that it used before are also re-allocated if they were available in the organization pool. The tenant and its services are now available for use.
To schedule data moves to a new region, contact UiPath Support to request enabling this feature for your cloud organization.
Before you begin
Before you begin, read the following information:
-
Depending on the services used by your tenant, multiple days to perform the move for cloud services may be necessary. The move date(s) are determined based on required version compatibility across regions.
-
Changing a tenant's region does not affect the region for your other tenants or for your organization.
To schedule a move to a new target region for your organization, follow the Moving data to a different region procedure.
For more information, refer to Organization and tenant services data.
-
To schedule a move to a new target region for multiple tenants, schedule the moves individually for each tenant.
-
While a four-hour window for region change is allocated, the average move downtime lasts less than 30 minutes. However, this interval can vary, depending on the size of the tenant. In rare cases, particularly for very large tenants, the move may take longer than hours.
-
During the scheduled downtime window you requested for the region move to be executed in, you are temporarily unable to access your tenant. During this time, any running jobs are paused and automatically resume after the move.
-
We recommend notifying your cloud organization members about the scheduled downtime window in advance.
-
Your robot execution logs history are only kept for 30 days. You can export the logs, if you want to preserve them. For more details, refer to Robot logs.
-
If you currently have any scheduled robot jobs or suspended robot jobs, we recommend temporarily disabling them during the downtime window. This proactive step helps ensure a seamless data migration process.
-
If you have processes within any tenants that are integrated with UiPath Apps, you must make some edits and replacements to update references. For details, refer to Replacing a process.
-
Insights service can be moved to a new region, but backfilling historical data can only be done within 30 days after moving Orchestrator. If Orchestrator is moved more than 30 days before Insights, Insights is moved without historical data. Therefore, after the transfer, users only have access to limited data.
Performing a tenant service data move
Canceling a tenant service data move
- Navigate to Admin.
- Select the tenant for which you want to cancel the scheduled move.
- Select Region change scheduled.
- Select Cancel request in the Scheduled data move right panel.
When deleting a tenant, you remove the tenant from your organization and also delete all of its services and any service data.
After deleting a tenant, all its licenses are freed up and available for you to allocate to other tenants.
A loading icon is displayed next to the tenant in the Tenants panel while the deletion is in progress. When complete, the tenant is removed from the Tenants panel.
In Admin > Tenant > Licenses, you can see information about the licenses currently allocated to each tenant.
To change the license quantities, click Edit allocation in the top right corner.
For more information, see Allocating licenses to tenants.