How to troubleshoot “Your browser does not support WebGL” messages.

This message indicates that there is a problem with WebGL in your browser.

That you visit this site very likely means that you have already picked up with the message you see in the screenshot above. To help you with getting rid of it, in the following paragraphs we want to provide you with some hints and useful links that should serve as a starting point for your troubleshooting procedure.

But first: WebGL is the technology behind HoloBuilder, used to display images and do its magic directly within the browser. Thus, it is essential for using HoloBuilder and has to work properly on your system.

Unfortunately, it is impossible to provide a “one-fits-all” kind of solution. Just because there are very many individual software and hardware as well as different platform and browser combinations out there, which could all contribute to the circumstances that are causing the error message to appear.
But chances are high that you will manage it by yourself if you use the provided information for your investigations:

  1. Start with a check if the browser you are using to work with HoloBuilder supports WebGL in general. Dark green means your browser’s capability at running WebGL is fine, a shape of green usually means that you should be good to go:
  2. Check if the browser’s WebGL features work properly on your system at all:
    You should see an animation of a rotating cube, which looks like following:
    A rotating cube shows that WebGL is working properly
  3. If it is not displaying the cube/working properly, search for information on how to enable WebGL in your browser:
  4. If you are using Google Chrome (the browser we strongly recommend for using HoloBuilder!) please check if hardware acceleration is enabled:
  5. Check if your graphics card is one of the blacklists that exist for different configurations:
    If yes, it means you are out of luck with using WebGL. The only thing you could try is to bypass the blacklist –  check AT YOUR OWN RISK! Please note that this can lead to unexpected behaviour, cause troubles and maybe even damages so that you do it only at your own risk. We cannot be held responsible for any consequences that happen due to the information you find and use in this context!
  6. Search Google Groups WebGL forum with relevant keywords, e.g. “support“:!forum/webgl-dev-list
  7. Search the official WebGL Wiki for further information:

After each step, you could use the test page again to check if you see the rotating cube and also reload HoloBuilder to see if the error message has gone. If so, enjoy using HoloBuilder. If not, please leave a comment or write us an email.