PDF download Download Article
A step-by-step guide to turn on WebGL in your browser
PDF download Download Article

WebGL (Web Graphics Library) is a JavaScript API that is used to render 2D and 3D graphics within a compatible web browser.[1] WebGL 2.0 is enabled by default in all major web browsers, but if you've disabled hardware acceleration, you may have inadvertently turned it off. If you're seeing the error "WebGL unsupported in this browser" or "could not initialize WebGL," this wikiHow guide will teach you how to enable WebGL 2.0 and WebGL (legacy) in Chrome, Safari, Edge, and Firefox on your PC or Mac.

Fixing WebGL 2 Errors in Your Browser

  • WebGL is enabled by default. To test WebGL in your browser, go to get.webgl.org/webgl2.
  • If WebGL isn't enabled in Chrome or Edge, it's usually because graphics acceleration is disabled. You can reenable it in your settings.
  • In Safari, you can enable WebGL in the Develop menu under "Experimental Features."
  • In Firefox, enable WebGL in about:support.
Method 1
Method 1 of 3:

Enable WebGL in Chrome & Edge

PDF download Download Article
  1. To do so, click the three-dot menu at the top-right, then select Settings at the bottom. You can also get there by typing chrome://settings or edge://settings into the address bar and pressing Enter or Return.
    • WebGL is enabled by default in Chrome. If you're getting an error in web-based tools like Canva or Figma, it may be because you've disabled hardware acceleration or due to driver issues.
  2. It's in the left panel of your Chrome settings.
    • If you're using Edge, click System and performance in the left panel instead, then click System in the right panel.
    Advertisement
  3. In Chrome, toggle on the "Use graphics acceleration in Chrome" switch. In Edge, toggle on "Use graphics acceleration when available."
    • This feature is also called "hardware acceleration." Sometimes disabling it is a part of troubleshooting other issues, such as when streaming video in Discord.
  4. If you're a developer, you may need to enable WebGL extensions in your Chrome flags. This may not be needed for all WebGL apps, but it won't harm anything to enable them. Here's how:[2]
    • Go to chrome://flags in Chrome, or edge://flags in Edge.
    • Type webgl into the search bar.
    • Select Enabled for both "WebGL Developer Extensions" and "WebGL Draft Extensions".
    • Click Relaunch.
  5. Go to get.webgl.org/webgl2/ and look for the rotating cube animation. If you can see the animation and "Your browser supports WebGL2", you're good to go.
  6. Type or paste chrome://gpu/ into the address bar and press Enter or Return. If WebGL is working, you should see "Hardware accelerated" next to WebGL in the top section. If you see anything here other than "Hardware accelerated," such as "Software only, hardware acceleration unavailable" or "Disabled", scroll down to the "Problems detected" area to see what's causing WebGL not to work.[3]
  7. You should see some more context under "Problems detected." Some common fixes:
    • If you see "WebGL has been disabled via blocklist or the command line" as the error, you can override it. Keep in mind, this isn't commonly recommended. Here's what to do:[4]
      • Go to chrome://flags or edge://flags.
      • Type ignore-gpu-blocklist into the search bar at the top.
      • Next to "Override software rendering list," select Enabled from the menu and relaunch Chrome.
    • For other errors, try updating your graphics drivers and updating your web browser.
    • You may also be using a browser extension or add-on that blocks WebGL, such as certain privacy extensions. Try disabling any privacy extensions and trying again.
  8. Advertisement
Method 2
Method 2 of 3:

Enable WebGL in Safari

PDF download Download Article
  1. You'll see the Safari menu in the menu bar when Safari is open.
  2. This opens your advanced Safari settings.[5]
  3. Now that you've enabled this menu, it'll appear in the menu bar.
  4. This displays a sub-menu to the side.
  5. If "WebGL 2.0" has a check mark next to it, WebGL is enabled.
    • If WebGL isn't working in Safari, you may need to update macOS.
  6. Advertisement
Method 3
Method 3 of 3:

Enable WebGL in Firefox

PDF download Download Article
  1. The address bar is at the top of the page.[6]
  2. This is the blue button on the page. The first time you visit this page, it informs you that some of these settings may be harmful to your browser stability, security, and performance. Click the blue button to accept the risk.
  3. The search bar is at the top of the page. This displays the WebGL setting.
  4. If it says "True" under the value for "webgl.disabled", double-click it to set the value to false.
    • If it says "false" already, WebGL is already enabled in Firefox.
  5. This displays information about Firefox.
  6. Both "WebGL 1 Driver Renderer" and "WebGL 2 Driver Renderer" are listed below "Graphics". If it displays a graphics card next to both of these, WebGL is enabled. If it does not display a graphics card, your graphics card may be blocklisted.
    • If your graphics card is blocklisted, you can override the blocklist by typing about:config in the address bar and searching for "webgl.force-enabled" and setting it to "True". However, this is not recommended.
  7. Advertisement

Expert Q&A

Ask a Question
200 characters left
Include your email address to get a message when this question is answered.
Submit
Advertisement
Did this article help you? Say thanks with a small tip.
icon
$1
$3
$5
Leave a Tip
Support our mission to help everyone in the world learn how to do anything.

Video

Tips

Submit a Tip
All tip submissions are carefully reviewed before being published
Name
Please provide your name and last initial
Thanks for submitting a tip for review!

About This Article

Nicole Levine, MFA
Written by:
wikiHow Technology Writer
This article was co-authored by wikiHow staff writer, Nicole Levine, MFA. Nicole Levine is a Technology Writer and Editor for wikiHow. She has more than 20 years of experience creating technical documentation and leading support teams at major web hosting and software companies. Nicole also holds an MFA in Creative Writing from Portland State University and teaches composition, fiction-writing, and zine-making at various institutions. This article has been viewed 251,192 times.
How helpful is this?
Co-authors: 7
Updated: May 5, 2026
Views: 251,192
Categories: JavaScript
Article SummaryX

1. Open Google Chrome.
2. Type "chrome://flags" in the address bar.
3. Select "Enable" next to "Webgl 2.0 Compute".
4. Click Relaunch Now.
5. Open Firefox.
6, Type "about:config" in the address bar and accept the risk.
7. Search "webgl.disabled" and double-click it if it says "True" under "Value".
8. Open Safari on Mac. 9. Open Preferences under the "Safari" menu. 10. Check ""Show Develop menu in menu bar" in the Advanced tab. 11. Click Develop in the menu bar. 12. Hover over "Experimental Features" and check "WebGL 2.0"

Did this summary help you?

Thanks to all authors for creating a page that has been read 251,192 times.

Is this article up to date?

Advertisement