WebView2 Data Folder Configuration and Troubleshooting
Dataedo Desktop uses Microsoft Edge WebView2 for certain UI features such as Data Lineage diagrams. WebView2 requires a writable folder to store its runtime data (the EBWebView folder). If it cannot find a writable location, some features may fail to load.
Data folder resolution order
On startup, Dataedo tries the following locations in order and uses the first one it can write to:
| Priority | Location | Path |
|---|---|---|
| 1 | Custom path from DataedoSettings.json | Value of WebView2UserDataFolder |
| 2 | Roaming AppData | %AppData%\Dataedo {version}\EBWebView |
| 3 | Local AppData | %LocalAppData%\Dataedo {version}\EBWebView |
| 4 | Local Temp | %LocalAppData%\Temp\Dataedo {version}\EBWebView |
| 5 | System Temp | %Temp%\Dataedo {version}\EBWebView |
| 6 | Application directory | Only available when Dataedo is not installed in Program Files |
Where {version} is the major version number of Dataedo (e.g., 26).
Setting a custom path in DataedoSettings.json
You can override the default folder resolution by specifying a custom path in the DataedoSettings.json file located next to Dataedo.exe.
Set the WebView2UserDataFolder value:
{
"WebView2UserDataFolder": "D:\\DataedoCache\\EBWebView"
}
Path rules
-
Backslashes in the path must be escaped as
\\(standard JSON syntax). For example:"D:\\DataedoCache\\EBWebView". -
Absolute and relative paths are supported. Relative paths are resolved relative to the
Dataedo.exedirectory. -
Environment variables are supported — for example
%USERPROFILE%\\DataedoWebView. -
Do not use paths inside
Program FilesorProgram Files (x86)— these directories are read-only for standard users and WebView2 will not be able to write there.
Program Files behavior
When Dataedo is installed in Program Files or Program Files (x86):
- The application directory fallback (priority 6 in the table above) is disabled because these folders are typically read-only for non-admin users.
- Dataedo must find a writable folder from priorities 1–5.
When Dataedo is installed outside Program Files (e.g., on a secondary drive), the application directory can be used as a last resort.
Troubleshooting
If WebView2 fails to initialize, Dataedo displays an error dialog with a code and the list of paths it attempted. Common error codes:
| Code | Meaning |
|---|---|
WV2-ACCESS | Permission denied — the folder is not writable by the current user |
WV2-NOTFOUND | WebView2 Runtime is not installed on the machine |
WV2-COM-XXXXXXXX | A COM/system error occurred (e.g., WV2-COM-8000FFFF for a catastrophic failure) |
Steps to resolve
- Verify that WebView2 Runtime is installed — download it from the Microsoft WebView2 page if needed.
- Check folder permissions — check if the current Windows user has read/write access to the target folder.
- Set a custom writable path in
DataedoSettings.jsonas described in Path rules above. - Check antivirus software — some antivirus programs block access to the
EBWebViewfolder. Add an exclusion if necessary. - Contact support — if the issue persists, submit a ticket and include the error code from the dialog.
Need help?
If you run into any problems or have questions, reach out to Dataedo support.