UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Extension for Chrome

🚧

Important:

UiPath Inc. and its affiliates, do not process, uses, accesses, or stores any customer data when using this product.

❗️

Warning:

This extension is no longer functional after updating Windows 10 to version 1903. We recommend reinstalling the extension after performing this specific Windows 10 update.

Install the Extension for Chrome

Requires Google Chrome version 64 or above.

The UiPath Extension for Chrome is bundled in the Studio setup. It is possible to install it even with no Internet access. The extension is installed globally if Google Chrome is installed system-wide, and per user if the browser is also installed this way. Please note that you may be asked to close Google Chrome while installing the extension, so be sure to save any pending work.

📘

Note:

It is recommended to close all Chrome instances before installing the extension.

From the Studio Installer

  1. Run the Studio Installer and click Advanced in the License Agreement section. The Product Features window is displayed.
  2. Click the Chrome Extension drop-down and choose to install this feature.
  3. Click Next. Studio setup continues while also installing the extension for Chrome.

From UiPath Studio

  1. Access the Tools page from the Studio Backstage View. The extensions you can install become visible.
  1. Click the Chrome button. A confirmation dialog box is displayed.
  2. Open Google Chrome and click the Add extension button. The extension is now installed and activated.

Please note that file access is disabled by default. To enable it:

  1. Click the Side Navigation Bar image alt textimage alt text > More Tools > Extensions. The chrome://extensions/ page is displayed.
  2. In the chrome://extensions/ page, navigate to the UiPath extension.
  3. Click the Details button. The UiPath Chrome extension details page is displayed.
  4. On this page, select the Allow access to file URLs check box.

From the Command Prompt

  1. Click the Windows Start button and type cmd in the search field.
  2. Right click on Command Prompt and run it as administrator.
  3. Change the directory to the UiPath installation folder (cd C:\Program Files (x86)\UiPath\Studio\UiPath).
  4. Use the SetupExtensions.exe command to run the corresponding file, and use one of the following arguments:
    • /chromeglobal - installs the UiPath Extension for Chrome per system.
    • /chrome - repairs the UiPath Extension for Chrome per system if available. Otherwise it installs the it per user.
  1. Open Google Chrome and click the Add extension button. The extension is now installed.

Please note that file access is disabled by default. To enable it:

  1. Click the Side Navigation Bar image alt textimage alt text > More Tools > Extensions. The chrome://extensions/ page is displayed.
  2. In the chrome://extensions/ page, navigate to the UiPath extension.
  3. Click the Details button. The UiPath Chrome extension details page is displayed.
  4. On this page, select the Allow access to file URLs check box.

As of 2018.3, installing the UiPath Extension for Chrome does not remove older versions. This does not interfere with your new or old automation projects. You can choose the Extension for Chrome to activate from the chrome://extensions/ page by simply clicking the Toggle Switch button of the corresponding extension.

Troubleshoot the Extension for Chrome Installation

This topic presents the most frequent reasons for which the UiPath Extension for Chrome might not work properly, and how to solve these issues.

Please note that browser automations with the extension for Chrome are currently possible on a single Chrome window.

📘

Note:

You need to use at least Google Chrome version 64 to perform browser automations.

Checking if the Extension for Chrome is Installed and Enabled

  1. In Google Chrome, navigate to chrome://extensions/.
  2. If the extension is not present, install it as explained here.
  3. Make sure the extension is updated to the latest version.

📘

Note:

Selecting the Developer mode check box at the top of the 'chrome://extensions/' page displays the Update button on the extension Details page.

Preventing Possible Issues

A. Enable access to files and incognito mode:

  1. In Google Chrome, navigate to chrome://extensions/.
  2. Select the UiPath extension.
  3. Make sure the Allow in incognito and Allow access to file URLs options are selected.

B. Check if the Chrome extension process is running:

  1. Open Task Manager.
  2. Check if the ChromeNativeMessaging.exe process is running.

C. Check the extension version and ID:

  1. Open the Registry Editor.
  2. Navigate to the HKEY_CURRENT_USER\SOFTWARE\Google\Chrome\NativeMessagingHosts\com.uipath.chromenativemsg_v2 key.
  3. Check if the Default REG_SZ value is C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\manifest.json.
  4. Open the manifest.json file with a text editor such as Notepad.
  5. Check if the path property leads to the ChromeNativeMessaging.exe file.
  6. Check if the allowed_origins field contains the correct extension ID (ex: chrome-extension://dkgencfabioofgdmhhjljpkbbchbikbh/).

ChromeNativeMessaging is Not Running

  1. In Google Chrome, navigate to chrome://extensions/.
  2. Remove the UiPath extension manually by clicking the Remove button.
  3. Reinstall it from UiPath Studio as explained here.

If the information above did not solve your issue, you can try getting additional information by viewing traces and analyzing the errors thrown by the UiPath extension. The following are types of traces you can collect and analyze.

Enabling Traces

General Extension Traces in Google Chrome

  1. In Google Chrome, go to chrome://extensions/.
  2. Select the Developer Mode checkbox at the top of the web page.
  3. Go to the UiPath extension and click background page. The Developer Tools page is displayed.
  4. Navigate to the Console tab. All the traces generated by the extension are displayed here.

📘

Note:

Errors are marked in red.

Traces Generated by the Web Page you Want to Automate

  1. On the webpage you want to automate, go to Side Navigation Bar > More tools > Developer tools (or press Ctrl+Shift+I). The traces generated by the UiPath extension for the current page are displayed.

📘

Note:

Errors are marked in red.

Full traces

  1. Open the Registry Editor.
  2. Navigate to the HKEY_CURRENT_USER\SOFTWARE\UiPath key.
  3. Double-click the WebExtensionTrace DWORD value. The Edit DWORD Value window is displayed.
  4. In the Value Data field, change the value to 1, and click OK. The value is saved.

📘

Note:

If the WebExtensionTrace DWORD value does not exist, you have to create it, by right-clicking the right panel, selecting New > DWORD (32-bit) Value, and providing the values mentioned above.

If the extension for Chrome is still not working then remove the extension from chrome://extensions/ and reinstall it as explained here.

Updated 4 days ago


Extension for Chrome


Suggested Edits are limited on API Reference Pages

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