Troubleshooting Steps to Enable WebGL for Failed to Initialize WebGL error
Do you see an error that says "Failed to Initialize WebGL" when you load EasyRoutes? Review the article below.
EasyRoutes uses WebGL for rendering our mapping elements and tools on modern browsers:
- Firefox (latest version)
- Chrome (latest version)
- Safari 9 and above
- Microsoft Edge 13 (with the most recent Windows 10 update)
To test whether WebGL is enabled in your browser, click here to run a quick WebGL test. If you do not see a spinning cube in the link, select your browser below and follow the troubleshooting steps provided to enable WebGL:
For Chrome, full support for WebGL is offered on all platforms, so if you are having trouble running WebGL on Chrome, you simply may need to update to a more recent version of Chrome.
If you're having trouble, try updating to the latest version of Chrome. If that doesn't work, make sure "Use hardware acceleration when available" is enabled in Chrome settings.
- Go to chrome://settings in your address bar, or click the three dots in the upper-right corner of the browser window and select Settings.
- Scroll to the bottom of the page and click on Advanced or System
- In the System section, toggle Use hardware acceleration when available to the ON position (the button should be blue).
- Click the Relaunch button to restart Chrome and apply your new settings.
If you are having trouble running WebGL in Firefox, please take the following steps:
- Go to about:config in your address bar.
- Search for webgl.force-enabled and make sure this preference is set to true. If it is currently set to false, click the toggle icon on the far right to change the value to true.
- Search for webgl.disabled and make sure this preference is set to false. If it is currently set to true, click the toggle icon on the far right to change the value to false.
- Restart Firefox to apply your new settings.
If you are still having trouble running WebGL in Firefox on a Windows computer after taking these steps, your graphics driver may be to blame; WebGL is not compatible with certain graphics drivers. If you continue to have trouble, you can either update your driver (Intel, AMD, or NVIDIA), or (recommended) simply switch to a compatible browser.
WebGL is generally enabled by default in Safari. However, if you are using a computer on which WebGL may present a security risk, you may have to enable WebGL manually by taking the following steps:
- From the menu bar, click Safari and then select Preferences.
- Select the Websites tab.
- Select WebGL from the list on the left side of the window. (Again, you will only see this option if WebGL has been disabled in your browser.)
- If you see the Shopify website listed on the right, select Allow from the drop-down menu.
- If you do not see see the Shopify website listed on the right, look for When visiting other websites in the lower-right corner of the window, and select Ask or Allow from the drop-down menu.