# Extension for Chrome

> :::important
UiPath Inc. and its affiliates do not process, use, access, or store any customer data when using this product.
:::

:::important
UiPath Inc. and its affiliates do not process, use, access, or store any customer data when using this product.
:::

:::important
Starting January 2023, the UiPath Extension for Chrome MV2 installed by older versions of `UiPathStudio.msi` will stop working in Chrome.

We highly recommend upgrading your UiPath Studio and Robot installations before this deadline.

See the full timeline for the Chrome migration to MV3 extensions [here](https://developer.chrome.com/docs/extensions/mv3/mv2-sunset/).

The UiPath Extension for Chrome MV3 is available in the following `UiPathStudio.msi` versions:

* 2022.4
* 2021.10.8
* 2020.10.14
* 19.10.9

These can be downloaded from the Resource Center of [UiPath Automation Cloud](https://cloud.uipath.com/).
:::

This extension helps you create browser automations in Google Chrome.

You can install this extension in multiple ways, as shown below:

## Install from UiPath Studio

1. Open Studio.
2. Navigate to **Home** &gt; **Tools** &gt; **UiPath Extensions**.
3. Select **Chrome** &gt; **Install**. Choose one of the available methods from the drop-down:
   * Group Policy Offline
   * Group Policy Online
   * All Users
   * Current User
   * Native Host Only
4. Open **Chrome** and navigate to `chrome://extensions`.
5. Enable the **UiPath Web Automation** extension if needed.

## Install From the Studio Installer

1. Run the `UiPathStudio.msi` installer.
2. Select an install mode, and then select **Advanced Settings** &gt; **Extensions** &gt; **UiPath extension for Chrome**. If Chrome is installed on your machine, the option is selected by default.
3. Click **Install**. Studio setup continues while also installing the extension for Chrome.

The UiPath Extension for Chrome can also be installed from the command line of [UiPathStudio.msi](command-line-parameters.md).

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-167385-a1668180.webp)

## Install 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 (
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.
5. Open Google Chrome and click the **Add extension** button. The extension is now installed.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-170695-23ceacb9.webp)

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

1. Click the**Side Navigation Bar****&gt; More Tools &gt; 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.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-171845-c54cb51d.webp)

## Install From Group Policy

You can also install the UiPath Extension for Chrome by using Group Policies. This method silently installs the extension and enables it, without requiring user confirmation.

### Offline

The Group Policy Offline installation method requires that the target machine is joined to a Microsoft Active Directory domain or Azure Active Directory.

It does not require access to the Chrome Web Store so it can be used in controlled environments for machines that have restricted Internet access.

`UiPathStudio.msi` uses this installation method by default if its requirements are met.

You can also use this installation method by running from an elevated command prompt:

```powershell
&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chrome-policy-offline /silent
```

If your organization uses Group Policies for browser extension management then the following changes are also required:

1. In the [ExtensionInstallForceList](https://chromeenterprise.google/policies/?policy=ExtensionInstallForcelist) policy, add the value:

   `ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml`
2. In the [NativeMessagingAllowList](https://chromeenterprise.google/policies/#NativeMessagingAllowlist) policy, add the value: `com.uipath.chromenativemsg_v2`
3. Set [DeveloperToolsAvailability](https://chromeenterprise.google/policies/#DeveloperToolsAvailability) Group Policy to the value `1` (Allow usage of the Developer Tools) to enable the full extension functionality. For more information, please check the [troubleshooting](chrome-extension.md#known-issues-specific-to-mv3-extensions) page.

If you need to host the UiPath extension in your internal Web Store you can find the `.crx` file at this location:

`C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_chrome_self_hosted_mv3.crx`

### Online

The Group Policy Online installation method requires that the target machine has access to the Chrome Web Store (`https://clients2.google.com/service/update2/crx` and `https://clients2.googleusercontent.com/crx`).

`UiPathStudio.msi` uses this installation method if its requirements are met and the machine is not joined to a Microsoft Active Directory.

You can also use this installation method by running from an elevated command prompt:

```powershell
&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromepolicyglobal /silent
```

If your organization uses Group Policies for browser extension management then the following changes are also required:

1. In the [ExtensionInstallForceList](https://chromeenterprise.google/policies/?policy=ExtensionInstallForcelist) policy, add the value:

   `gflmmjnkmhahgnfcgjckfaekifpehnjk;https://clients2.google.com/service/update2/crx`
2. In the [NativeMessagingAllowList](https://chromeenterprise.google/policies/#NativeMessagingAllowlist) policy, add the value:

   `com.uipath.chromenativemsg_v2`
3. Set [DeveloperToolsAvailability](https://chromeenterprise.google/policies/#DeveloperToolsAvailability) Group Policy to the value `1` (Allow usage of the Developer Tools) to enable the full extension functionality. For more information, please check the [troubleshooting](chrome-extension.md#known-issues-specific-to-mv3-extensions) page.

## Uninstalling

The UiPath Extension for Chrome can be uninstalled by running from an elevated command prompt:

```powershell
&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromecleanup /silent
```

You can also uninstall by opening Studio, navigating to **Home** &gt; **Tools** &gt; **UiPath Extensions**, and selecting **Chrome** &gt; **Uninstall**. The extension will be uninstalled with the same method used for the installation. This method is displayed in the disabled drop-down next to the **Uninstall** button.

## Chrome version requirements

The UiPath Extension for Chrome MV2 requires Chrome version 64 or greater.

The UiPath Extension for Chrome MV3 requires Chrome version 98 or greater.

When using one of the installation methods described above, the browser version will be checked and the extension with the appropriate format (MV2 or MV3) will be automatically installed.

## New extension features

### Automating Chrome apps

Starting with `UiPathStudio.msi` 2022.4 the UiPath Extension for Chrome can be used to automate [Chrome Apps](https://support.google.com/chrome/answer/9658361).

## Troubleshooting

Your system administrator might have configured **Group Policies** that prevent the UiPath Extension for Chrome from working. To enable it, please follow the instructions from the [Group Policies page](chrome-group-policies.md).

For any other issues regarding the UiPath Extension for Chrome, please view the detailed [troubleshooting](chrome-extension.md) page.
