Create or import an app

With Web AppBuilder for ArcGISArcGIS Enterprise (Developer Edition), you can create a 2D or 3D app from scratch, import an existing app directly from ArcGIS Online or , or import the downloaded ZIP file from your computer. You can also use a template to create a 2D app.

Create an app

  1. On the home page, click Create New. To create a 2D app, choose the Default (2D) option to create the app from scratch, or use one of the templates to create the app. The former opens the builder environment, and the latter opens the template-based configuration environment. To create a 3D app, choose the Default (3D) option.
  2. Provide the app name, description, and thumbnail and click OK.
    • With the Default (2D) or Default (3D) option, the builder opens. Creating an app in the builder environment involves the following workflow:
      1. Choose the look and feel of the app.
      2. Specify the web map or web scene authored by your portal, which usually contains a basemap and operational layers.
      3. Configure the widgets.
      4. Brand the app.
      5. Preview the app on devices if you build the 2D app.
        Note:
        The 3D app does not support devices.
      6. Save the app.
      7. Launch the app.
    • With the template option, the template-based configuration environment opens. Configure the parameters as needed, and preview and save the app. If the template does not meet your criteria, click the Saved drop-down arrow and click Advanced Configuration to open the builder environment. You can always come back to the template-based configuration by clicking the Saved drop-down arrow and clicking Template Based Configuration.

Import an existing app

You can build a 2D or 3D app on top of an existing app by importing it from your ArcGIS Online organization or Web AppBuilder account.

  1. On the home page, click Import and choose Import from my account to open the Import App window.

    The Import App window displays the available apps created by Web AppBuilder integrated into your portal.

    Note:

    The imported app must be from the same portal as the installation of Web AppBuilder (Developer Edition) where you logged in.

  2. Choose an app and click OK.
    • If the imported app was created in an earlier version of Web AppBuilder, it upgrades automatically before import. When successful, you'll see the app listed on the home page. Otherwise, a failure message appears and asks you to check the log file, which is appbuilder.log in the \server\logs directory of the Web AppBuilder installation.

      Failure message
      Note:

      You cannot import an app that has a later version than the Developer Edition. For example, If you type the wabVersion variable in debug mode with a Web AppBuilder Online app, you may find the value is 1.3. You will be unable to import it to Developer Edition 1.1. In general, Developer Edition 1.0 is equal to Web AppBuilder Online 1.1. Starting with Developer Edition 2.0, Developer Edition and Web AppBuilder Online share the same version number. For example, Developer Edition 2.0 is equal to Web AppBuilder Online 2.0.

    • If the imported app shares the same version of Web AppBuilder for ArcGIS (Developer Edition), it is automatically imported and added to the app list.
  3. If an app with the same name already exists, a suffix is automatically added to the imported app name.

Download a ZIP file

You can build a 2D or 3D app on top of an existing app by importing it from your computer. The existing app must be a ZIP file, created and downloaded from Web AppBuilder (Developer Edition), Web AppBuilder integrated into ArcGIS Online, or Web AppBuilder integrated into ArcGIS Enterprise.

  1. On the home page, click Import and choose Import from my computer.
  2. Browse to the ZIP file directory, which is downloaded from Web AppBuilder (Developer Edition), Web AppBuilder integrated into ArcGIS Online, or Web AppBuilder integrated into ArcGIS Enterprise.
  3. Choose the file and click Open.
    • If the imported app was created by an earlier version of Web AppBuilder, it upgrades automatically before import. When successful, you'll see the app listed on the home page. Otherwise, a failure message appears and asks you to check the log file, which is appbuilder.log in the \server\logs directory of the Web AppBuilder installation.

    • If the imported app shares the same version of Web AppBuilder for ArcGIS (Developer Edition), it is automatically imported and added to the app list.
  4. If an app with the same name already exists, a suffix is automatically added to the imported app name.