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 fact-checked, ensuring the accuracy of any cited facts and confirming the authority of its sources.
This article has been viewed 251,192 times.
Learn more...
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.
Steps
-
Open your Chrome or Edge settings. 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.
-
Click the System tab. 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 -
Enable graphics acceleration. 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.
-
Enable WebGL developer and draft extensions. 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.
-
Go to the WebGL test site. 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.
-
Check GPU details if WebGL still doesn't work. 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]
-
Fix the detected problems in your flags. 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.
- 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]
-
Click the Safari menu and select Settings. You'll see the Safari menu in the menu bar when Safari is open.
-
Click the Advanced tab. This opens your advanced Safari settings.[5]
-
Click the Develop menu. Now that you've enabled this menu, it'll appear in the menu bar.
-
Hover over Experimental Features. This displays a sub-menu to the side.
-
Click WebGL 2.0. 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.
-
Type about:config in the address bar. The address bar is at the top of the page.[6]
-
Click Accept the Risk and Continue. 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.
-
Type webgl.disabled in the search bar. The search bar is at the top of the page. This displays the WebGL setting.
-
Double-click webgl.disabled if it says "true". 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.
-
Type about:support in the address bar. This displays information about Firefox.
-
Check the graphics card next to "Webgl Driver Renderer". 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.
Expert Q&A
Video
Tips
References
- ↑ https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API
- ↑ https://help.constructiononline.com/en/scheduling-webgl-and-hardware-acceleration
- ↑ https://esko.my.site.com/s/article/KB170039112?language=en_US
- ↑ https://developer.chrome.com/docs/web-platform/webgpu/troubleshooting-tips
- ↑ https://help.constructiononline.com/en/scheduling-webgl-and-hardware-acceleration
- ↑ https://get.webgl.org/webgl2/enable.html
About This Article
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"





















