This map requires WebGL

From OpenStreetMap Wiki
Jump to navigation Jump to search
Main article: Using OpenStreetMap
A globe, rendererd using WebGL
Using WebGL to render the Globe

You are seeing this message because you are trying to view an OpenStreetMap-based map that requires WebGL to function correctly.

If your browser does not support WebGL, or if WebGL is disabled, the map cannot appear.

What is WebGL?

WebGL (Web Graphics Library) is a web standard that allows browsers to render interactive 2D and 3D graphics using the computer’s graphics hardware (GPU).

Modern vector-based maps commonly rely on WebGL to efficiently render map data, especially when supporting smooth zooming, rotation, and large datasets.

Why does this map require WebGL?

This map uses a WebGL-based renderer to:

  • Efficiently display vector map data
  • Support smooth zooming and panning
  • Enable rotation, pitch, and other advanced visual features

Without WebGL, these features are not available, and the map cannot be shown.

Common reasons for this error

This message is shown when WebGL is unavailable in the browser. Common causes include:

  • The browser does not support WebGL
  • WebGL is disabled in browser settings
  • Hardware acceleration is disabled
  • An outdated browser or graphics driver
  • WebGL is blocked by browser extensions or privacy settings

How to resolve the issue

Upgrade your browser

Ensure you are using a recent version of a modern browser that supports WebGL, such as:

  • Firefox
  • Chrome
  • Safari
  • Edge

After upgrading, reload the page.

Enable WebGL and hardware acceleration

Often, WebGL support exists but is disabled.

General steps (vary by browser):

  • Open the browser settings
  • Enable hardware acceleration
  • Ensure WebGL is not disabled in advanced or experimental settings
  • Restart the browser

Check browser extensions

Some privacy-focused or security-related browser extensions may block WebGL.

To test this:

  • Temporarily disable all extensions, for example via loading the map in a private/incognito window
  • Test with a fresh browser profile

Try a different browser

If WebGL cannot be enabled in your current browser, try opening the map in another supported browser.

Testing WebGL support

You can use an online WebGL test page to verify whether WebGL is available in your browser.

If WebGL is reported as unavailable, the issue is likely related to browser configuration or system graphics support.

Known limitations

WebGL may not be available in some environments, including:

  • Old graphics hardware
  • Systems without proper graphics drivers
  • Virtual machines or remote desktop sessions
  • Browsers with strict security or hardening configurations

In these cases, WebGL-based maps may not function.

See also