Navigation: Learn About All Features  > Application Settings > Rendering Engine >

Customize the WebView2 Browser options





Customize the WebView2 Browser options


In HTML Executable, choose Application Settings => Rendering Engine.



A lot of Chromium (WebView2) options can be configured there.




Lets you add some custom Chromium command-line arguments. For example, if you want to disable the GPU accelerated video display, add `--disable-accelerated-video`. To add multiple arguments, separate each two arguments by space.



Determines if autofill functionality is enabled.




Allows a compiled file within the eBook or application to be opened in its dedicated application when the associated link is visited by the end user. HTML Executable determines this behavior based on the file extension; if the file extension is included in the list for this property, then the file will be directly opened in its dedicated application.


Please note that this action temporarily extracts the file onto the user's hard drive, making it potentially vulnerable to unauthorized copying. Therefore, it is essential to consider the security aspects before using this property.


The list of extensions in the AutoOpenExtensions property should be separated by semicolons. For example, if you want to open .docx and .xlsx files in their dedicated applications, the property value should be set as .Docx;.xlsx.




Indicates whether the custom error page defined in Dialog Boxes should be used to display missing pages (404 file not found). If True, a 200 OK status will be returned to the web browser. If False, a 404 error will be returned to the web browser and the standard 404 error page will be shown.




Lets you specify a custom User-Agent for the web browser.




Defines which locale (language) should be used by the Chromium engine (useful for localization of default buttons and menus for instance). List of values are available in the `CEFRuntime\locales` subfolder of the HTML Executable's location.


For instance, to use the French locale, enter `fr`.




Indicates whether Chomium Developer Tools should be enabled or not. End users can access these tools with the context-menu of the internal browser.




Controls whether drag/drop of external resources is allowed or not.




Lets you disable the "Find Text" menu command.




Lets you disable the drag/drop feature for images. For instance, if the end user drags and drops an image onto Windows Explorer, the Chromium engine will save the image as a file into the folder. It's a possible leak for your compiled image files. So, to avoid this leak, activate this property.




Allows your application and Chromium engine to store cache and temporary files onto the end user's computer. By default, it will be a subfolder in the User Data directory as explained here.




Prevents downloads of internal resources (for instance, on default video player).


The Chromium engine allows end users to download a played video (or audio) resource using the context menu. If you cannot disable this menu from HTML, it is still possible to prevent the download of the audio or video file using this option.


For instance, if you enter `audio/mp3;audio/ogg`, HTML Executable will prevent .MP3 and .OGG files from being downloaded, but not played back by the video or audio player.




If enabled, no audio will be played.




Determines if pinch to zoom functionality is enabled.


Determines if private mode is enabled. Default is False.


Determines if single sign-on is enabled. Default is False.




Determines if swipe navigation is enabled.


Determines if tracking prevention is enabled. Default is True.


Troubleshooting CORS problems


If the console (in Developer Tools) shows navigation errors such as "Uncaught DOMException: Blocked a frame with origin "null" from accessing a cross-origin frame.", you can disable CORS checks in WebView2 by adding the --disable-web-security to the AdditionalChromiumArgs field (see above).