Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
EditorExportPlatformWeb¶
Inherits: EditorExportPlatform < RefCounted < Object
Exporter for the Web.
Description¶
The Web exporter customizes how a web build is handled. In the editor's "Export" window, it is created when adding a new "Web" preset.
Note: Godot on Web is rendered inside a <canvas> tag. Normally, the canvas cannot be positioned or resized manually, but otherwise acts as the main Window of the application.
Tutorials¶
Properties¶
Property Descriptions¶
String custom_template/debug
File path to the custom export template used for debug builds. If left empty, the default template is used.
String custom_template/release
File path to the custom export template used for release builds. If left empty, the default template is used.
int html/canvas_resize_policy
Determines how the canvas should be resized by Godot.
None: The canvas is not automatically resized.
Project: The size of the canvas is dependent on the ProjectSettings.
Adaptive: The canvas is automatically resized to fit as much of the web page as possible.
String html/custom_html_shell
The custom HTML page that wraps the exported web build. If left empty, the default HTML shell is used.
For more information, see the Customizing HTML5 Shell tutorial.
bool html/experimental_virtual_keyboard
Experimental: This property may be changed or removed in future versions.
If true, embeds support for a virtual keyboard into the web page, which is shown when necessary on touchscreen devices.
bool html/export_icon
If true, the project icon will be used as the favicon for this application's web page.
bool html/focus_canvas_on_start
If true, the canvas will be focused as soon as the application is loaded, if the browser window is already in focus.
String html/head_include
Additional HTML tags to include inside the <head>, such as <meta> tags.
Note: You do not need to add a <title> tag, as it is automatically included based on the project's name.
Color progressive_web_app/background_color
The background color used behind the web application.
int progressive_web_app/display
The display mode to use for this progressive web application. Different browsers and platforms may not behave the same.
Fullscreen: Displays the app in fullscreen and hides all of the browser's UI elements.
Standalone: Displays the app in a separate window and hides all of the browser's UI elements.
Minimal UI: Displays the app in a separate window and only shows the browser's UI elements for navigation.
Browser: Displays the app as a normal web page.
bool progressive_web_app/enabled
If true, turns this web build into a progressive web application (PWA).
bool progressive_web_app/ensure_cross_origin_isolation_headers
When enabled, the progressive web app will make sure that each request has cross-origin isolation headers (COEP/COOP).
This can simplify the setup to serve the exported game.
String progressive_web_app/icon_144x144
File path to the smallest icon for this web application. If not defined, defaults to the project icon.
Note: If the icon is not 144x144, it will be automatically resized for the final build.
String progressive_web_app/icon_180x180
File path to the small icon for this web application. If not defined, defaults to the project icon.
Note: If the icon is not 180x180, it will be automatically resized for the final build.
String progressive_web_app/icon_512x512
File path to the smallest icon for this web application. If not defined, defaults to the project icon.
Note: If the icon is not 512x512, it will be automatically resized for the final build.
String progressive_web_app/offline_page
The page to display, should the server hosting the page not be available. This page is saved in the client's machine.
int progressive_web_app/orientation
The orientation to use when the web application is run through a mobile device.
Any: No orientation is forced.
Landscape: Forces a horizontal layout (wider than it is taller).
Portrait: Forces a vertical layout (taller than it is wider).
bool variant/extensions_support
If true enables GDExtension support for this web build.
bool variant/thread_support
If true, the exported game will support threads. It requires a "cross-origin isolated" website, which may be difficult to set up and is limited for security reasons (such as not being able to communicate with third-party websites).
If false, the exported game will not support threads. As a result, it is more prone to performance and audio issues, but will only require to be run on an HTTPS website.
bool vram_texture_compression/for_desktop
If true, allows textures to be optimized for desktop through the S3TC algorithm.
bool vram_texture_compression/for_mobile
If true allows textures to be optimized for mobile through the ETC2 algorithm.