Version: 2022.3
Language : English
WebGL introduction
Advanced overview

WebGL browser compatibility

Unity’s WebGLA JavaScript API that renders 2D and 3D graphics in a web browser. The Unity WebGL build option allows Unity to publish content as JavaScript programs which use HTML5 technologies and the WebGL rendering API to run Unity content in a web browser. More info
See in Glossary
support for desktop browsers differs depending on the browser. It supports browsers providing the following conditions are true:

  • The browser is WebGL 2 capable. Note: Unity no longer provides support for WebGL 1 in builds created with the Auto Graphics API option. For more details, see WebGL 1 deprecation.
  • The browser is HTML 5 standards-compliant.
  • The browser is 64-bit and supports WebAssembly.

Unity WebGL doesn’t support mobile devices. It might work on high-end devices, but current devices are often not powerful and don’t have enough memory to support Unity WebGL content.

Unity WebGL supports some compressed texture formatsA file format for handling textures during real-time rendering by 3D graphics hardware, such as a graphics card or mobile device. More info
See in Glossary
. For information on the compressed texture formats that Unity WebGL supports, see Recommended, default, and supported texture compression formats, by platform.

Desktop Browser Desktop Platforms
Google Chrome Windows, macOS, Linux
Mozilla Firefox Windows, macOS, Linux
Apple Safari macOS
Microsoft Edge Windows, macOS, Linux

Notes:

  • Unity WebGL also supports the latest version of the Chromium-based Edge browser.
  • Apple Safari doesn’t support WebGL 2 in versions before Safari 15.
  • Apple Safari doesn’t support IndexedDB for content running in an iFrame.
  • On Linux, you might have to install Advanced Audio Coding (AAC) codec support via a package manager (for example, the GStreamer package).

WebGL 1 deprecation

From Unity 2022.1, the Auto Graphics API setting no longer includes WebGL 1 Graphics API. However, if you still need to add support for WebGL 1 in your project then follow these steps:

  1. Open the Player SettingsSettings that let you set various player-specific options for the final game built by Unity. More info
    See in Glossary
    window and expand the Other Settings section.
  2. Disable the Auto Graphics API option and explicitly add WebGL 1 (Deprecated) to the Graphics API list. Unity will remove support for WebGL1 entirely in Unity 2023.1

WebGL 1 graphics card blocklists

GPU blocklists apply. Older graphics cards might not support WebGL. For more information, see:


  • WebGL 1 deprecated from the Auto Graphics API list in 2022.1
  • Brotli compression first documented on this page in User Manual 5.6
  • Updated with most recent compatibility information in 2019.1
WebGL introduction
Advanced overview