The Pega Browser Extension (PBE) component, released in build 19.1.115, replaces the individual Chrome and Edge extensions released in earlier 19.1 builds. PBE updates the Google Chrome and Microsoft Edge browser extensions to comply with the Chromium Project Manifest V3 specification.

Google Chrome and Microsoft Edge support for Manifest V2 is currently scheduled to end in 2024. For the latest information and timelines, monitor the Chrome Developer's website.

Review the following information to learn about the reason for the changes and how to respond.

• Pega Browser Extension overview
• Timelines and important dates
• Installing the Pega Browser Extension
• Pega Robotic Automation project compatibility
• Supported product versions and technologies

Pega Browser Extension overview

What is the Pega Browser Extension (PBE)?

Pega Browser Extension is a standalone component of Pega Robotic Automation, just like Pega RPA Service and Pega Native Foundation. With this component, you can automate applications that run in Chrome and Edge by using the Universal Web Adapter. PBE includes the extension and the native messaging host. The native messaging host transmits communications between Robot Runtime or Robot Studio, and the browser.

What is the difference between PBE and the earlier 19.1 Chrome and Edge extensions?

The extensions that come with PBE are updated to the latest version of the extension manifest (Manifest V3). PBE isolates the extensions (called the Pega Robotics Automator) and other related elements into a separate, installable component that is similar to Pega RPA Service and Pega Native Foundation. Pega Robotic Automation version 19.1.115 and later include PBE.

What is a manifest file?

Google Chrome and Microsoft Edge are based on the open-source Chromium browser platform. Chromium browser extensions require a JSON-formatted manifest file, named manifest.json. This file describes the behavior of the extension and provides essential information about the extension, including its name, version, an array of permissions the extension might use, and other technical details.

What is Manifest V3?

Manifest V3 is the latest manifest extension for Chromium extensions and was created by the Chromium Project. Manifest V3 replaced Manifest V2. Manifest V3 is included in Chrome and Edge. For more information, visit the following websites:

• Migrate to Manifest V3
• Manifest V2 support timeline

How do I know if I have a Manifest V2 or Manifest V3 Pega Browser Extension?

The Manifest V2 extension is named Pega Robotic Automation for Browsers, and its version number starts with 1.0. The Manifest V3 extension is named Pega Robotics Automator, and its version number starts with 3.1.

What is the benefit to me to use PBE?

Because PBE is a separate, installable component, you can update it without having to update Robot Studio and Robot Runtime.

What is a self-hosted extension?

Self-hosting is the practice of hosting an extension outside of the Chrome Web Store. Self-hosting provides several advantages, including making it easier and quicker for you to distribute extensions to your users.

Self-hosting also allows Pega to continue to automate and maintain compatibility with automations that use the ExecuteScript or InvokeScript methods. Self-hosting allows the Pega RPA team to release builds faster.

Timelines and important dates

When will Google and Microsoft stop supporting Manifest V2?

Support ends in 2024. Follow this link to see Google's Manifest V2 end of support schedule:

https://developer.chrome.com/docs/extensions/mV3/mV2-sunset/

Follow this link to see Microsoft's Manifest V2 end of support schedule:

https://docs.microsoft.com/en-us/microsoft-edge/extensions-chromium/developer-guide/manifest-V3

When will Pega stop supporting Manifest V2?

Like Google and Microsoft, Pega ends support for the Manifest V2 in 2024. If you are not already using Pega Browser Extension (PBE), do so as soon as possible. Keep in mind that you can install PBE at any time and not only move to Manifest V3, but also enjoy an easier extension update process.

When should I start using PBE?

For systems that only use Pega Robotic Automation 19.1, you should migrate to PBE now, before the Google and Microsoft-imposed deadlines, if you have not already done so.

The Pega RPA team recommends that you migrate 19.1 implementations to PBE when you install 22.1 because both items (PBE and Pega Robot Runtime 22.1) must be installed before the Pega Synchronization Engine can maintain these items.

Keep in mind that if you are using Pega Robotic Automation 19.1 and 22.1 on the same computer, you must use PBE. PBE is compatible with both 19.1 and 22.1, and is required for 22.1. For more information on PBE and version 22.1, see PBE frequently asked questions.

Can I use both extensions (Pega Robotics Automator and Pega Robotic Automation for Browsers) on the same computer?

No. If you run Pega Robotic Automation 19.1 and 22.1 on the same computer, you must uninstall the Pega Robotic Automation for Browsers extension and install PBE to automate applications that run on a Chrome or Edge browser.

Installing the Pega Browser Extension

How do I install PBE?

The Pega Browser Extension is included when you download version 19.1.115 and later of Robot Studio and Robot Runtime from the My Pega website. You can extract the PBE installation files from this download and apply PBE to earlier 19.1 installations as needed. After you install PBE, use the Pega Synchronization Engine to maintain the version of PBE that is running on your system.

How do I prepare for PBE?

To allow users to install a self-hosted extension, add the extension ID to the ExtensionInstallAllowlist policy in the Group Policy Editor for your Active Directory Domain Service. Alternatively, you can set the ExtensionInstallForcelist policy to force-install an extension on your users’ computers. For more information on setting Group Policy, see the following articles:

• Automating applications that run on Google Chrome
• Automating applications that run on Microsoft Edge

For more information on setting Group Policy, see the following articles:

• Using Microsoft Group Policy to control Chrome policies
• Using Microsoft Group Policy to control Edge policies

How do I upgrade to PBE?

Pega Robot Studio and Pega Robot Runtime version 19.1.115 and later include PBE. You can install PBE by itself or as part of a Robot Studio or Robot Runtime installation. To install as part of a Robot Studio or Robot Runtime installation, select the option to install the Pega Browser Extension when you run the Setup wizard. For more information, see the installation instructions.

Can I use the Pega Synchronization Engine to install PBE?

No. You must install and configure all new components. After you install PBE, you can configure the Pega Synchronization Engine to ensure proper maintenance and updates.

Pega Robotic Automation project compatibility

Do I need to upgrade my projects after I install PBE?

No, one of the benefits of using PBE is that it is a separate component from Robot Studio and Robot Runtime. This enables you to use PBE without rebuilding your solutions, unless you are using the Electron translator. If your project uses the Electron translator, then you must upgrade the project.

How do I know if my projects are incompatible with PBE?

If your 19.1 project contains an adapter that uses the Electron translator, update the project to a build that includes PBE to make the project compatible with PBE. If you are unsure whether your projects are compatible with PBE, contact Pega Support.

Supported product versions and technologies

How do I handle browser updates?

Best practice is to turn off automatic updates of your browsers. Only deploy new browser versions after you have had time to smoke test your automations.

Which technologies are not backward compatible?

Currently, the only technology that is not backward compatible is Electron.

Can I use any version of 19.1 with PBE?

It depends; if your projects use the Electron translator, which is not backward compatible, then use a build that includes PBE. If your projects do not use the Electron translator, then all versions of 19.1 are compatible with PBE.

Can I use any version of 8.0 SP1 with PBE?

No, Pega Robotic Automation 8.0 SP1 does not support PBE -- and 8.0 SP1 is no longer supported by Pega.

What browser versions does PBE support?

The Pega Browser Extension works with Chrome versions 88 and later, and all versions of Edge.