Search
⌃K

Enable WebGL

WebGL is a browser rendering feature that allows our apps to run with desktop-class graphics performance. It comes built-in to all modern browsers and doesn't require any additional plugins. It is required to run Rive. Occasionally, some browser configurations have this feature turned off. Read more to see how to enable it on Chrome and Firefox (which are our two recommended browsers).

How to Enable WebGL in Chrome

  • Open Chrome Settings (you can type chrome://settings in your address bar).
  • Click the Show Advanced Settings button at the bottom of the page.
  • In the System section, make sure that Use hardware acceleration when available is checked. Restart your browser.
If WebGL is still not working after that, then follow the next steps.
  • Type chrome://gpu in your address bar.
  • Take a look at the items listed under Graphics Feature Status. Each line should say "Hardware accelerated" in green text, as in the screenshot below.
  • If one of the lines doesn't say "Hardware accelerated", check the Problems Detected list further down the page.
If Canvas is not hardware accelerated:
  • Type chrome://flags in your address bar.
  • Make sure that Accelerated 2D canvas is enabled.
If your graphics card or drivers are blacklisted, first try updating your drivers. If it still doesn't work, you can try to override the blacklist. Be careful with this setting as it is generally not recommended.
Type chrome://flags in your address bar. Enable Software rendering list. Restart your browser.

How to Enable WebGL in Firefox

  • Type about:config in your address bar.
  • Search for web.gl and make sure it's set to false.
If WebGL is still not working after that, then follow the next steps.
  • Type about:support in your address bar.
  • Under the Graphics section, check the WebGL Renderer row. It should list your graphics card manufacturer and model.
  • If it doesn't, then make sure you've updated your graphics card drivers.
  • If it says anything about your card or drivers being "Blocked," then you can try to force enable WebGL. Be careful with this setting as it is generally not recommended.
  • Type about:config in your address bar.
  • Search for webgl.force-enabled and set it to true.
To read more about blacklists, upgrading your graphics card drivers, and for the source of a lot of the information above, check out TachyonVortex's great post on superuser.com.
Last modified 3yr ago