Migrate ModelBuilder to ArcGIS Pro

ModelBuilder in ArcGIS Pro is fundamentally similar to ModelBuilder in the other ArcGIS Desktop applications. The model diagram appearance is similar, and you still build models by adding data and geoprocessing tools and connecting them to form processes. In ArcGIS Pro, you can view, edit, and run models you built in previous releases of ArcGIS Desktop.

There are also some differences. Learning these differences can help your transition to using ModelBuilder in ArcGIS Pro.

Compatibility

Note:

It is recommended before editing a model in ArcGIS Pro ModelBuilder that you make a copy of the original toolbox. If you edit and save the model in ArcGIS Pro, that model will not be usable in other ArcGIS Desktop applications.

Models that are newly created, as well as any models that have been edited and saved in ModelBuilder in ArcGIS Pro, cannot be used in other ArcGIS Desktop applications. To use these models, you must save the toolbox to a new toolbox of the correct version. Right-click any toolbox, select Save Toolbox to Version, and select a target version.

Save Toolbox to Version
Save a toolbox for use in a previous version of ArcGIS Pro or for use in ArcGIS Desktop.

You can also use the Consolidate Toolbox tool to analyze the models in your toolbox for previous version compatibility, and save the toolbox and related contents in a format that can be used in earlier versions.

Selection, connection, and navigation

ModelBuilder previously included dedicated tools to pan, zoom, select elements, and connect elements. In ArcGIS Pro, there is a Select mode, a Pan mode, and Zoom In and Zoom Out buttons.

Select mode

The default is Select mode. In Select mode, you can click an element to select it. You can move the selected element or connect it to another element. An element does not have to be selected to connect it to another element.

To connect an element to another element, complete these steps:

  1. Hover over a model element until the pointer changes to the connection mode pointer Point.
  2. Click the element and drag the pointer to another element to draw a connection.
  3. Choose whether to connect the element to a parameter or an environment, or use the element as a precondition.

    Connect a data variable to a tool.

You can also pan the model diagram when in Select mode using the vertical and horizontal scroll bars at the right side and bottom of the ModelBuilder view.

Pan mode

In Pan mode, you can drag the pointer anywhere in the model diagram to pan. You cannot select or connect model elements in Pan mode.

Calculate Field

The Calculate Field tool has been significantly changed in ArcGIS Pro due to the 64-bit architecture of the application.

Calculate Field no longer supports VB expressions; expressions can only use Python or Arcade syntax. If your model is saved with VB expressions, you will need to update the expression to one of the supported languages. Follow these steps to update your Calculate Field expressions:

  1. Right-click the model and select Edit.
  2. Double-click the Calculate Field tool to open it.
  3. Change the Expression Type parameter to Python or Arcade.
  4. Rewrite the Expression parameter using valid syntax.
  5. Click OK to commit the changes to the tool.
  6. Repeat these steps for any other Calculate Field tools in the model.
  7. Click Save to save the model.

Learn more about Calculate Field expressions

Managed data

The Managed option has been removed in ArcGIS Pro ModelBuilder.

When you run a model, output data is created for each process in the model (unless the process only modifies the input). Some of the data created is of no use after the model is run since it was only created to connect to another process that creates new output. This data is called intermediate data. When a model is run from the Geoprocessing pane, the outputs marked as Intermediate Data are deleted automatically. When a model is run in ModelBuilder, you can delete the outputs marked as Intermediate Data by clicking the Intermediate button on the ModelBuilder tab.

Learn more about intermediate data

Colors, shapes, and images

Models created in ArcGIS Pro have a slightly different color scheme compared to models created in other ArcGIS Desktop applications. In ArcGIS Pro, you cannot change the colors, shapes, or background images of model elements, and you cannot add images to the model diagram. Models that were saved with custom colors, shapes, and images from other ArcGIS Desktop applications will display these custom settings and objects in ArcGIS Pro.

Model element colors
The colors of model elements in ArcGIS Pro are shown.

Lists and series

Lists and series are not supported in ArcGIS Pro. You can use iterators to perform batch processes on a collection of datasets.