Web AppBuilder for ArcGIS (Developer Edition)

Deploy your app

The app you created with Web AppBuilder for ArcGIS can be downloaded and hosted on your web server. Any app that is downloaded must be registered with ArcGIS Online or Portal for ArcGIS if the app references nonpublic items.


Regardless of where you deploy the app, it still needs access to the web map.

Download the app

To download the app, on the home page, click the download button on the app. A ZIP file bearing the app's name is created and downloaded to your local drive and is located in the download directory defined for your browser.

Deploy the app

To deploy the app on your web server, complete the following steps:

  1. Unzip the downloaded app.
  2. Deploy it on your web server.
  3. Browse to the directory of the app and open the app config.json file.
  4. Add a proxy to the proxy property in the app config.json file. See Use proxy for details.
  5. Add and register the app. See Add apps and Register your app for details.
  6. Copy and paste the AppID to the appId property in the app config.json file. Save the file.

The app is now available by browsing to http://<your server>/<app name>/.


It is strongly recommended using AppID to take advantages of the platform authentication with OAuth and SAML when deploying your app. Otherwise, you must set the proxy in the config file to make the app work in Internet Explorer 8 and Internet Explorer 9.

Do the following to customize the app:

Configure the app for group access

If your app consumes a non-public web map shared with groups, and the members of the groups are from different ArcGIS Online organizations, do the following to allow all group members to access the web app:

  1. Open the app's config.json file and locate the portalUrl property.
  2. Replace the organizational URL with www.arcgis.com.
  3. Locate the map property. If it contains the portalUrl subproperty, repeat step 2.

Supported browsers

  • The 2D app supports the following browsers:
    • Chrome
    • Firefox
    • Safari 3 and later
    • Edge
    • Internet Explorer 11

    When you open the deployed app with OAuth in Internet Explorer 11 or Microsoft Edge, you may receive a pop-up message asking if you want to close the tab. When you click Yes, the pop-up disappears but nothing loads in the app. If this happens, add .arcgis.com to the trusted sites in your browser's settings.

  • The 3D app supports the following browsers:
    • Chrome
    • Firefox
    • Safari 7.1 and later
    • Edge
    • Internet Explorer 11

    3D apps do not support devices. Using a 3D app in Web AppBuilder requires a desktop web browser that supports WebGL. The latest versions of the most common desktop browsers have WebGL built-in. To test if your browser has WebGL enabled, open get.webgl.org. To troubleshoot WebGL-related issues, visit WebGL Troubleshooting. Also see the ArcGIS Online topic specific to rendering scene viewer features for additional information.

Supported versions of ArcGIS API for JavaScript

In Web AppBuilder for ArcGIS developer edition 2.12, 2D apps support ArcGIS API for JavaScript 3.28, and 3D apps use the ArcGIS API for JavaScript 4.11. See the System requirements for additional information.