Skip To Content

Download the app

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

Note:

Wherever you deploy the app, it still needs access to the web map.

Download the app

Download the app from the My Content tab of the content page.

  1. In the My Content tab of the content page, click the app to view its item details.
  2. Click Download on the Overview page. The ZIP file downloads to your computer.

Deploy the app

Do the following to deploy the app on your web server.

  1. Unzip the downloaded app.
  2. Deploy the app on your web server.
  3. Add a proxy to your app. Refer to Use proxy for details.
  4. Add and register the app. Refer to Add apps and Register your app.
  5. Copy and paste the app ID to the appId property in the app config.json file. Save the file.
  6. View the app in your browser.

Customize the app

Do the following to customize the app.

  • Add custom widgets:
    1. Put the custom widget in the widgets folder.
    2. Add the widget to the app’s config.json file.

      The example below uses the Demo widget. Add it to the config.json file.

      {
            "uri": "widgets/Demo/Widget"
          },
  • Configure the app and widgets. Refer to JSON reference.
  • Reference the preferred ArcGIS API for JavaScript. Refer to Change the URL of ArcGIS API for JavaScript.

Supported browsers

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

    When you open the deployed the app with OAuth in Internet Explorer 11 or Microsoft Edge, you may receive a pop-up asking if you want to close this tab. After you click Yes, the pop-up disappears but nothing loads in the app. If this is the case, 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 up
    • Edge
    • Internet Explorer 11
    Caution:

    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 render scene viewer features for additional information.

Supported versions of ArcGIS API for JavaScript

2D apps support the ArcGIS API for JavaScript 3.24, and 3D apps use the ArcGIS API for JavaScript 4.7. See the System Requirements for additional information.