Subscribe

UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Update Studio

About Updating

The process of updating an older Studio release to this release differs depending on the Studio edition currently installed on your machine - Enterprise or Community.

The installation artifacts can be downloaded from the Resource Center in UiPath Automation Cloud, provided to you when you purchase Studio, or provided by your customer success manager or the support team.

Versioning Scheme

UiPath uses calendar versioning, labeling its products with the year of the release (major) followed by the month (minor) and the patch (micro) version.

Updating the Enterprise Edition

Manual Update

About 32-bit and 64-bit Versions

In releases prior to 2021.4, Studio and Robot were available as 32-bit applications. Starting with version 2021.4, a 64-bit installer is available by default. A 32-bit version is also available and can only be installed on 32-bit operating systems. UiPathPlatformInstaller.exe is no longer available starting with version 2021.4.

Update existing UiPathStudio.msi and UiPathPlatformInstaller.exe installations as follows:

  • Use the 64-bit version of the installer (UiPathStudio.msi) to update existing 32-bit and 64-bit installations on 64-bit operating systems.
  • Use the 32-bit version of the installer (UiPathStudio-x86.msi) to update existing installations on 32-bit operating systems.

Existing 32-bit installations on 64-bit operating systems that are using the default installation path (C:\Program Files (x86)\UiPath\Studio) are migrated to C:\Program Files\UiPath\Studio after updating with the 64-bit installer. If the older version is installed in a custom location, the update does not change the installation path.

Performing the Update

  1. Double-click the installer to launch the installation wizard.
  1. Read and accept the License Agreement. Please note that by accepting the terms of the license agreement, you implicitly accept the terms of use of UiPath activity packages and their dependencies.
  2. Select Upgrade to upgrade to this version keeping your previous setup and proceed to step 5, with no additional configuration required. Alternatively, select Advanced Settings to make changes to your existing setup and proceed to step 4.
  3. If you opted to configure the upgrade, you can configure the following installation options:
  4. Click Upgrade, wait for the installation to complete, and then click Launch UiPath Studio.

For information on performing the update from the command line, see Command Line Parameters.

Considerations for Updating from Versions Prior to 2018.4

  • If the entire UiPath suite is installed on a single machine, and you want to update from v2018.2 or older versions, you are required to first do so on Orchestrator and then Studio and Robot. If you first update your Studio, your Orchestrator instance is removed. This is due to a change in the installers' Upgrade Code.

  • If you are updating from v2017.1, v2018.1, or v2018.2, note that all old local activities packages are lost. Please back up before updating.

  • Please keep in mind that, upon upgrade from v2018.2, the activities packages are cumulated in the C:\Program Files\UiPath\Studio\Packages folder.

    If you have projects created with a Studio version prior to v2018.3, and they have dependencies in the %localappdata%/UiPath/Activities folder, add the path as a feed in the Package Manager, so that the projects can reference them.

    After updating from a version prior to v2018.3, Studio performs an automatic migration of dependencies when the project is opened. Read more about Dependency Migration as part of the Core Activities Split.

    It is not recommended to perform manual changes to NuGet.config or any configuration files, and instead, UI or command-line arguments should be used. However, if manual changes were indeed made to configuration files, it is recommended to back up these files before upgrading to a later Studio version.

📘

Note:

The location of the activity packs has changed from %programdata%\UiPath\Activities in 2016.2 to %localappdata%\UiPath\Activities in 2018.1 and above.

This means that, when updating from 2016.2 to 2018.1, 2018.2, or 2018.3, the activity packs must be reinstalled to work properly. More info can be found in the Managing Activities Packages chapter.

Automatic Update

Starting with v2021.10, administrators can set up policies for automatically updating Studio, StudioX, Robot, and Assistant from Orchestrator. When a policy triggers the automatic update process, an Update Available notification is displayed by the UiPath Update Agent prompting you to start the update.

  • Select Update now to perform the update. Please note that Studio and Assistant are closed during the update.
  • Select Later to mute the notification. The update process can be resumed at any time in the 24 hours after the initial notification by clicking the UiPath icon in the system tray and then clicking Check for updates. If not resumed by the user, the update is installed automatically after 24 hours.

📘

Notes:

  • During the update process, the Robot does not start any jobs until the update is completed.
  • If there are any processes running on the machine, the user is prompted to choose to either stop the process or wait for it to finish and continue with the update.
  • If a Studio session is open, the user is prompted to save the progress. If the user doesn’t react, Studio closes and the process is saved as-is at that time and can be recovered after the update is completed, while the Robot waits for any process to complete and starts the update process afterwards.

Updating the Community Edition

If you installed Studio and Robot using the Community Edition installer and activated it with a Community license, Studio and Robot are automatically updated as soon as a new version is available on the selected channel, Stable or Preview.

If you installed Studio and Robot using the Community Edition installer and activated it with an Enterprise license, Studio and Robot are automatically updated to the latest Stable release, regardless of the update channel you selected.

📘

Note:

Only Community Preview installations running version 2021.8 can be automatically updated to the 2021.10 Community Preview release. To update to v2021.10 from versions 2021.6 or older, either manually install the 2021.10 preview version or update to v2021.8 first.

When a new version is available, an Update Available notification is displayed by the UiPath Update Agent prompting you to start the update.

  • Select Update now to perform the update. Please note that Studio and Assistant are closed during the update.
  • Select Later to mute the notification. The update process can be resumed at any time in the 24 hours after the initial notification by clicking the UiPath icon in the system tray and then clicking Check for updates. If not resumed by the user, the update is installed automatically after 24 hours.

If you manually update your Community Edition Studio, your user settings are not lost, but the existing UiPath extension for Chrome may be removed from your browser. The content of the current UiPath folder from %localappdata%\UiPath installation folder is removed and the setup fails if you previously performed selections with UI Explorer in a Java application. Please note that these issues do not occur when Studio automatically updates to the latest version.

Selecting the Update Channel

You can choose an update channel by going to Home (Studio Backstage View) > Help and selecting either Stable or Preview. Please note that once you change your selection, you have to restart the application for the change to take effect.

Updated about a month ago


Update Studio


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.