Troubleshoot WebView2

This article explains how to resolve WebView2 issues in Bp Premier.

WebView2 is Microsoft’s new embedded web control, built on Microsoft Edge. Web controls allow web-related technology to be embedded in software.

Visit the Microsoft website to find out more about WebView2.

Bp Premier uses WebView2 to display web content and documents directly within Best Practice. WebView2 uses less memory than previous web content and document display methods.

In this article:

WebView2 Troubleshooting

You may require assistance from your IT provider to complete the below troubleshooting steps.

WebView2 Runtime error

If you experience the below WebView2 error, this means that WebView2 has failed to download during your install of Bp Premier.

This is likely due to the computer not being connected to the internet at the time of installation.

To resolve this error:

  1. Click here to download the Microsoft WebView2 runtime.
  2. Once the download has finished, navigate to the Downloads folder on your computer and locate the file MicrosoftEdgeWebview2Setup.exe.
  3. Right-click on MicrosoftEdgeWebview2Setup.exe and select Run as administrator. If the User Account Control alert appears, click Yes.

    4. The WebView2 runtime download screen will appear.

    Once the download is complete, the screen will close.

  4. Restart Bp Premier to run it with WebView2.

Documents appearing blank

If the document viewer displays a blank screen when you attempt to view a document, try the following solutions.

Run Bp Premier as an administrator

  1. Close Bp Premier.
  2. Right-click the Bp Premier desktop item and select Run as administrator.
  3. Access the file you are having issues viewing.
  4. Close Bp Premier.
  5. Re-open Bp Premier as a normal user.
  6. Navigate to the file again and see if you can access it.

Change the Best Practice Software folder permissions

Review permissions on the following folders or registry key so that the appropriate user or login has access:

  • C:\Program Files\Best Practice Software
  • C:\Program Files (x86)\Microsoft\EdgeWebView
  • C:\Users\%Userprofile%\AppData\Local
  • Computer\HKEY_CURRENT_USER\SOFTWARE\Best Practice Software\Best Practice.
  • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Best Practice Software

Add exceptions in Anti-virus software

In your practice's anti-virus software, set up exceptions for each user profile's Temp folder (e.g. C:\Users\%Userprofile%\AppData\Local\Temp).

An exception will also need to be set up in your anti-virus software for msedgewebview2.exe.

Clear the temp directory

Navigate to C:\Users\%Userprofile%\AppData\Local\Temp and remove all contents from this folder.

Sites using a Citrix Environment

If your site uses a Citrix environment, your IT provider may need to disable Citrix API hooks.

See How to Disable Citrix API Hooks on a Per-application Basis for more information.

Sites using FSLogix

If your practice uses the latest version of FSLogix and has a file redirection in place for the temp directory (C:\Users\%Userprofile%\AppData\Local\Temp), disable the redirection

Update the following registry key:

  1. Search for 'registry editor' or 'regedit' in the Windows search bar and click on the search result. The Windows Registry Editor will appear.
  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix\Profiles.
  3. On the right side of the screen, there will be an entry called SetTempToLocalPath. Right-click SetTempToLocalPath and select Modify. The Edit DWORD (32-bit) Value screen will appear.
  4. Update the Value data field to 2 and Click OK.

Last updated: 14 May 2025.