Web
Wraps a remote URL in a WebView. This is the most common — and most configurable — app type.
When to use
Landing pages, tools, dashboards, documentation, and internal systems that already live at a URL.
Core config
The Web type's core config is the WebView behavior (backed by WebViewConfig).
Target & engine
- Target URL — the site to load.
- Browser engine — System WebView by default; optional GeckoView (download it in Browser Kernel before building; required for ECH). See Browser Kernel.
User agent & display
- User agent mode — system default or a custom UA string (
userAgentMode,customUserAgent). - Desktop mode — request the desktop version of the site (
desktopMode). - Zoom & viewport — enable zoom, initial scale, and viewport mode.
Injection
- JS/CSS injection — inject scripts/styles at document-start, document-end, or idle (
injectScripts). View Code opens the built-in editor, including a userscript stored as a file. Saving the editor updates the draft. Leaving the script dialog without saving keeps the stored script.
Popups & windows
- New-window behavior — how popups/new windows open (
newWindowBehavior: same window, external browser, popup window). - Popup blocker — block popups (
popupBlockerEnabled). - JS can open windows — with policy (
javaScriptCanOpenWindows,jsOpenWindowsPolicy).
Notes
- The Web editor exposes the full set of capability cards (fullscreen, splash, ad blocking, DNS, disguise, and more) in a single screen — Web apps have one combined editor rather than separate core/common config.
- For multiple sites in one app, use Multi-Web.
- To archive a site for offline use, use Offline Pack.
- System WebView keeps a
<video>inside a length the page specified in px, rem, em, vw, or vh, on the video or an ancestor. A player that already fits, and a full-width percentage player, stay as they are. Gecko follows the page's CSS on its own. - A Godot web export starts on System WebView. The
Version/4.0token is removed only when the user agent also contains Chrome, so the engine is not treated as Safari 4. A real Safari version string is left as it is.
