Open ModelBuilder by creating a model or editing an existing model.
Create a model
Create a model by doing one of the following:
- Click ModelBuilder
on the Analysis tab to create a model in the project toolbox.
- Right-click an existing toolbox or toolset in the Catalog pane, and select New > Model.
When you create a model, it opens for editing in ModelBuilder. A new model starts as a blank model view, where you can add data and tools and connect them to form processes. The new model opens with a temporary welcome message that expires when you add a model element or save the model.
Edit an existing model
To view an existing model diagram in ModelBuilder, right-click a model in a toolbox, and choose Edit. The model diagram appears in ModelBuilder with the same layout, extent, and appearance as when the model was saved.
Save a model
You can save changes for any model that is open in ModelBuilder. Click the Save button
to save the model in its current state. Set a model to save automatically by
enabling the Auto Save button
. When this button is enabled, the model
is saved as edits are made. Click the drop-down menu under the Save button, and click the Save As button
to save the model with a different name or to a different toolbox.
When you save a model, the contents of all variables and parameters are saved as well as the state of each process and the appearance and layout of the model diagram.
Change a model name and label
A model has both a name and a label as follows:
- The model label is what is displayed on the open model view tab, as well as in the Catalog and Geoprocessing panes. The model label can contain spaces and other special characters.
- The model name is an internal name used by the system that is used when running the model from Python. The model name can only contain alphanumeric characters and cannot start with a number.
You can change both the model name and label in the model Properties setting. To view and change model properties, do one of the following:
- Right-click the model in its toolbox, and select Properties.
- If the model is open in ModelBuilder, click Properties on the ModelBuilder tab in the Model group.
Repair a broken model
Models can become broken if the model cannot find or use one or more of the tools in it. The following are some common causes of this problem:
- A tool in the model was renamed or deleted.
- The toolbox containing a tool in the model was moved, renamed, or deleted.
- A tool in the model has had its parameter names changed.
- A tool in the model has had a parameter added or removed.
- A tool in the model has had a parameter data type changed.
- A tool in the model is not licensed.
Typically, the tools in a model that cause this type of problem are custom script and model tools rather than system tools that are installed with ArcGIS Pro. Custom script or model tools can be renamed, moved to a different toolbox, or have their parameters modified, causing the models that use the tool to break.
Models can only be repaired by editing the model in ModelBuilder. Right-click the model in its toolbox, and select Edit. Validating a model will often reveal problems, as will running the model. When you run the model, messages appear in a window indicating whether a tool in the model is invalid or cannot be run.
If a tool in the model cannot be located or loaded, it appears gray in color. You can replace this broken tool by double-clicking the tool in ModelBuilder and using the Browse dialog box to select the replacement tool. When you click OK, the broken tool is removed from the model and the replacement tool is added to the model in the location of the removed broken tool.