Skip to content

Add-In Troubleshooting: Add-In Could Not Be Started and Other Issues

5 min read

 

If you successfully installed the Add-In and configured your corporate firewall to let RG Email Sidebar traffic through, yet on trying to open it in MS Outlook you get an error notification “ADD-IN ERROR. This add-in could not be started. Close this dialog to ignore the problem or click “Restart” to try again”, that might be caused an issue with RG Email Sidebar rendering. This article describes the ways to resolve the issue. The solutions are only applicable for MS Outlook Desktop for Windows.

 

 

Solution 1: Refresh Microsoft Browser Configuration

The error may occur with various Add-Ins / plugins installed in MS Outlook Desktop for Windows. The below guidelines are official ones provided by Microsoft.

The first step is to determine the versions of Windows OS and MS Outlook that you are using. These versions define which native Microsoft browser is used to render MS Outlook Add-Ins; that might be MS Edge or MS Internet Explorer.

See this Microsoft article to find out which one is used in your system based on your Windows version and Office package version combination. Users running the latest Windows 10 and Microsoft 365 Office updates typically have their Add-Ins rendered by MS Edge.

 

If your system uses MS Edge

Sometimes the error is caused by MS Desktop App Web Viewer getting corrupt. Take the steps below to re-install this module.

1. Close all MS Office apps running in your system, including MS Outlook
2. Run the following cmdlet in Windows PowerShell or command line on your PC, with Admin permissions: 

powershell Add-AppxPackage -register -disable {Windows folder on system disk path e.g. 'C:\Windows\'}\SystemApps\Microsoft.Win32WebViewHost_cw5n1h2txyewy\AppxManifest.xml

3. Run MS Outlook and try opening RGES Add-In to see if the issue was resolved

 

 

 

If none of Microsoft Add-Ins work or Sidebar controls become unclickable (WebView2 runtime)

The issue where important Sidebar elements become unclickable, e.g. the Save or Create button, has a technical cause on Microsoft Outlook side. Specifically, due to the ongoing Microsoft transition from old MS Edge to Chromium MS Edge some MS Outlook for Windows versions have an interface frames rendering issue with MS Edge. Microsoft is planning to roll out a complete solution in a future MS Windows update.

An official workaround provided by Microsoft:

Note

The workaround works only for Windows 10 and Office 365 or Microsoft 365 package version 16.0.13530.20424 or newer. See this Microsoft article to learn how to check what version you have

 

1. Close MS Outlook
2. Close MS Edge browser windows, if any are opened
3. Download MS Edge Webview2 runtime from this location: https://go.microsoft.com/fwlink/p/?LinkId=2124703

If this package does not work in your configuration, install an alternative version. Browse this Microsoft resource for versions compatible with different MS Edge builds and x86, x64, or arm64 architecture.

 

4. Open your Downloads folder and install Webview2 on your Windows system. The runtime’s security and stability are guaranteed by Microsoft, see this article for complete information on Webview2
5. Launch MS Outlook and check if RG Email Sidebar Add-In can be opened and key Sidebar controls are clickable

 

 

 

If that does not help

 

 

If your system uses Internet Explorer

Since Microsoft stopped supporting the Internet Explorer 11 desktop application on most versions of Windows 10, Revenue Grid discontinued support of RG Email Sidebar for Internet Explorer and older MS Outlook versions that use the Internet Explorer browser to render add-ins.

Since the older Desktop versions of MS Outlook use Internet Explorer 11 engine to render embedded add-ins in its interface, it will be impossible to run RG Email Sidebar on these versions of MS Outlook. Refer to this Microsoft help article for more information about browsers used by Office Add-ins.

We recommend that our customers migrate from Internet Explorer-rendering versions to the newest versions of MS Office products that use other browsers (MS Edge, MS Edge Chromium or user’s default browser) to ensure RG Email Sidebar functioning.

Make sure that you are using an MS Outlook version that is included in the following MS Office builds:

1. For customers the Desktop MS Office versions set up via MS Office Click-to-Run installation:

  • Microsoft Edge with WebView1: Microsoft 365 ver.16.0.11629 or later and Microsoft 365 version older than 16.0.13530.20424

  • Microsoft Edge with WebView2: Microsoft 365 ver.16.0.13530.20424 or later with additionally installed WebView2

2. For customers using the Desktop MS Office versions set up via a Windows Installer (MSI) package:

  • Microsoft Edge with WebView2: Office 2021 or later

 

If you are using an MS Office build older than 16.0.11629 or version older than Office 2021, you should consider upgrading to the latest versions from the list above. Additionally, make sure that you run Windows 10 build 1903 or newer. If it’s older, we recommend you to upgrade your Windows system to the latest build.

Tip

Refer to this Microsoft article to find out what version of MS Office you are using.
To find out which version of Windows operating system you are running, consult this Microsoft guide

   

Contact Revenue Grid Support

If none of the above listed solutions resolves the issue, contact our Support team for further assistance.

 

Also see the following articles:

“Browser version is not supported” troubleshooting

RG Email Sidebar mass deployment scenarios

How RG Email Sidebar works with EWS

Microsoft Consent framework

Microsoft App Consent Experience