Deployment

The experience you created with ArcGIS Experience Builder can be downloaded and hosted on a web server. Any experience that is using private content must be registered on ArcGIS Online or ArcGIS Enterprise. In order to provide the best user experience for your end-users, please see the system requirements prior to deploying your experience.

Download the experience

To download the experience on the experience gallery home page, click on the ellipsis (three dots) and click Download (make sure there is no error in your client terminal when the app includes custom widgets). A ZIP file is created and downloaded to your local drive. It is located in the download directory defined for your browser.

Deploy the experience

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

  1. Unzip the downloaded experience and copy the folder to your web server.
  2. If your app has private content, complete steps 3-6, otherwise your experience is deployed.
  3. Add and register the app. See Add apps and Register your app for details.
  4. Copy the AppID and open the app config.json file located in the root app folder (e.g. <.zip file root>\cdn\0\config.json).
  5. Create a clientId property under the attributes object.
  6. Paste the AppID in the clientId property in the app config.json file. Save the file.
Use dark colors for code blocksCopy
    
1
2
3
4
"attributes": {
    "portalUrl": "https://exb.maps.arcgis.com",
    "clientId": "EXBAPPsag0XSRtpj"
  },

The app is now available by browsing to your server/app name/index.html.

Service worker cache

Experience Builder uses service workers to proactively control the caching of assets to improve the load times of your application. If a deployed application requires an update to its source code, config.json, or any other changes, you can do the update in the Developer edition, then re-download and deploy the app. However, if you need to do the update in the download package directly, you must complete the following steps to update the service worker cache.

  1. In your app directory, rename cdn/0 to cdn/1.
  2. Modify any source code or changes you need to make in the app.
  3. Open index.html on your application's root folder.
    • Change <base href="./cdn/0/"/> to <base href="./cdn/1/"/> .
    • Change the buildNumber = '0' to buildNumber = '1'.

To get better performance, here are some recommended settings for the cache header:

  • Cache index.html for a very short period such as one minute or no cache.
  • Cache the cdn folder for a long period such as one year.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.