Web SDK supported browsers

The Azure Maps Web SDK provides a helper function called atlas.isSupported. This function detects whether a web browser has the minimum set of WebGL features required to support loading and rendering the map control. Here's an example of how to use the function:

if (!atlas.isSupported()) {
    alert('Your browser is not supported by Azure Maps');
} else if (!atlas.isSupported(true)) {
    alert('Your browser is supported by Azure Maps, but may have major performance caveats.');
} else {
    // Your browser is supported. Add your map code here.


The Azure Maps Web SDK supports the following desktop browsers:

  • Microsoft Edge (current and previous version)
  • Google Chrome (current and previous version)
  • Mozilla Firefox (current and previous version)
  • Apple Safari (macOS X) (current and previous version)

See also Target legacy browsers later in this article.


The Azure Maps Web SDK supports the following mobile browsers:

  • Android
    • Current version of Chrome on Android 6.0 and later
    • Chrome WebView on Android 6.0 and later
  • iOS
    • Mobile Safari on the current and previous major version of iOS
    • UIWebView and WKWebView on the current and previous major version of iOS
    • Current version of Chrome for iOS


If you're embedding a map inside a mobile application by using a WebView control, you might prefer to use the npm package of the Azure Maps Web SDK instead of referencing the version of the SDK that's hosted on Azure Content Delivery Network. This approach reduces loading time because the SDK is already be on the user's device and doesn't need to be downloaded at run time.


The following Web SDK modules are also supported in Node.js:

Target legacy browsers

You might want to target older browsers that don't support WebGL or that have only limited support for it. In such cases, we recommend that you use Azure Maps services together with an open-source map control like Leaflet. Here's an example that makes use of the open source Azure Maps Leaflet plugin.

Additional code samples using Azure Maps in Leaflet can be found here.

Here are some popular open-source map controls that the Azure Maps team has created plugin's for.

Next steps

Learn more about the Azure Maps Web SDK:

Map control

Services module