In order to use version 4.x, your browser must meet certain system requirements.
For best performance, we recommend the latest versions of modern, standards-based browsers:
- Microsoft Edge
- Safari 11 and later
About Internet Explorer 11
Esri does not recommend using IE 11. While some aspects of the API will work with Internet Explorer 11, there are numerous limitations as detailed below:
- Internet Explorer 11 does not support WebAssembly, so the clientside projection engine will not work. This also impacts all client-side auto-reprojection for when spatial reference other than WGS84 or Web Mercator is specified, for example when adding graphics/layers, measurement, client-side query by distance, using CSVLayer, GeoJSONLayer and client-side FeatureLayer.
- Internet Explorer does not support SVG, thus will not display SVG paths for IconSymbol3DLayer, or SVG symbols for SimpleMarkerSymbol and PictureMarkerSymbol.
- The WebGL implementation in Internet Explorer is not optimized for memory-intensive applications, and it might not work reliably when opening certain scenes or when rendering large datasets.
Microsoft recommends using Microsoft Edge (instead of IE11).
For desktop browsers, it is recommended to have at least 8 GB system memory and modern graphics hardware for both 2D and 3D.
Minimum requirements are a high-performance graphics card with at least 512 MB of video memory. For the best performance, it is recommended that you have a graphics card with at least 1 GB of video memory, especially for working with larger or more memory-intensive 3D scenes. High-performance, stand-alone graphics cards typically have better performance than integrated graphics cards. To get more detailed information about WebGL requirements, visit the khronos.org WebGL wiki.
Mobile devices should have a minimum of 2GB of RAM (4 GB recommended), a powerful multi-core processor and graphics card, and the latest Android or iOS version installed.
3D mobile capabilities are currently only supported on the following devices. To determine if an issue is related to mobile hardware or the browser, it is recommended to first attempt to reproduce the issue on one of the supported desktop browsers listed above.
- iOS Safari on iPhone 8, iPhone XS, iPad Pro
- Android Chrome on Samsung S8, Samsung S9, Samsung S10, Samsung Tab S3, Samsung Tab S4
When using a Virtual Desktop Infrastructure (VDI), the virtual desktop client will need access to the hardware requirements listed above for desktop browsers. It is also recommended that you use the client specifically designed for your VDI. You will need to test and potentially adjust the VDI configuration to get optimal visualization performance.
About web servers
If developing a traditional web application that is to be accessed via the browser, the recommended approach is to deploy it to a web server and access it via http:// or https:// rather than
file://. Web server software is available free of charge for all operating systems. For Windows, IIS is recommended. On Mac OS and Linux, Apache is a popular option but any web server will do.
Some API classes and modules have additional system requirements which are noted on a class by class basis in the API reference. For example, due to security considerations the Locate widget and Track widget don't work on insecure origins. The Fullscreen widget only works with browsers that implement the Fullscreen API. Thus, iOS Safari is not supported.