Get started with ModelBuilder (beta)

Note:

ModelBuilder is currently in beta. Share your experience and seek support through the forums available in the ModelBuilder Early Adopter Community.

The workflow for using ModelBuilder (beta) consists of the following steps: create a model, add and connect data and tools, and run the model.

Create a model

Models are created or opened on the ModelBuilder (Beta) tab of the Analysis pane.

Use the following steps to open the ModelBuilder (Beta) pane and create a model:

1. In Map Viewer, click Analysis on the Settings (light) toolbar.
2. Click ModelBuilder (Beta) .

   The ModelBuilder (Beta) pane appears.

   

   If the ModelBuilder (Beta) tab is not available, contact your ArcGIS administrator. Your account may not meet the requirements to use ModelBuilder.

3. In the ModelBuilder (Beta) pane, click Connect.

   Note:

   Connecting to an analysis session consumes credits.

   ModelBuilder connects to an analysis session and the Create model button is enabled.

4. Click Create model .

   The Create analysis model window appears.

5. Provide the required information for the new analysis model item (title, folder, tags, and summary) and click Save.

An empty model opens at the bottom of the map in active mode.

Build the model

Models are built using data and tools, with the output of one tool being used as an input to another tool. You build your model by adding data and tools and connecting them to form a complete workflow.

Complete the following steps to add and connect data and tools:

1. On the action toolbar, click Add data to add data to the model.

   Select one or more layers from the map or browse to add layers. The layers are added to the model as input data elements.

2. On the action toolbar, click Add tools to add tools to the model.

   

   Select one or more of the available analysis tools. The analysis tools are added to the model as tool elements.

3. Click the port on the right side of a data element and drag it to the port on the left side of a tool element to connect the data and tools, and select the parameter in which the input will be used.

   

4. Double-click a tool element or select Open on the element toolbar to open the tool dialog box.

   

5. Configure the tool parameters.

   Required parameters are marked with a red dot. For more information on tool parameters, click the help button next to the parameter or visit the individual tool help.

   The Result layer group allows you to create intermediate data, create a new hosted layer, or overwrite an existing hosted layer.

   Learn more about model outputs

6. On the tool dialog box, click Confirm.

The tool dialog box closes and the tool validates.

Run a model

Once all data and tools have been added and connected, and the required tool parameters have been set, the model can be run.

Complete the following steps to run a model:

1. On the model toolbar, click Run .

   

   The model runs. The tool elements in the model show the status of the tool run. Outputs from tools configured to publish a hosted layer are added to the map.

2. Optionally, click the History tab in the Analysis pane to view more details about the model run.
3. On the model toolbar, click Save to save changes to the analysis model item.
4. In the ModelBuilder (Beta) pane, click Disconnect to disconnect from the analysis session.