Version: 2021.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 1 or WebGL 2 capable. Note: Unity has marked WebGL 1 support for deprecation and will remove it in a future release.
  • 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 enough and don’t have enough memory to support Unity WebGL content. To make the end user aware of this, the default template for Unity WebGL displays a warning message when the end user attempts to load a Unity WebGL application on a mobile browser. To remove this warning from your application, add your own WebGL template. For information on how to do this, see Add a WebGL template.

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 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:

  • 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

In version 2021.2, Unity marked support for the WebGL 1 Graphics API as deprecated. Currently, there are no changes in behavior and Unity still includes the WebGL 1 Graphics API if you enable the Auto Graphics API Player Setting. However, Unity will remove support for WebGL 1 In a future release.

WebGL 1 graphics card blocklists

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


  • 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