Skip To Content

Open ModelBuilder

You can open ModelBuilder by creating a new model or editing an existing model. There are two ways to create a new model:

  • Click the ModelBuilder button on the Analysis tab in the ribbon to create a new model in the project toolbox.
    ModelBuilder on the Analysis tab
  • Right-click an existing toolbox or toolset and choose New > Model.

When you create a new model it is automatically opened for editing in ModelBuilder. A new model starts as a blank view.

Edit an existing model

If you want to view an existing model diagram in ModelBuilder, right-click a model in a toolbox and choose Edit. The model diagram will display in ModelBuilder with the same extent and appearance with which the model was saved.

Save a model

You can save changes for any model that is open in ModelBuilder. Click Save Save to save the model in its current state. Click Save As 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

The model label is what is displayed in the Project and Geoprocessing panes; the model name is used in Python. Because the model name is used in Python, it must not contain spaces or special characters.

You can change both the model name and label in the model Properties. There are two ways to view and change model properties:

  • Right-click the model in its toolbox and select Properties.
  • If the model is open in ModelBuilder, click Properties in the ModelBuilder ribbon tab.

Repair a broken model

When a model displays with a broken icon it means the model cannot find or use one or more of the tools within the model. These are some common causes of this problem:

  • The tool was renamed or deleted.
  • The toolbox containing the tool was moved, renamed, or deleted.
  • Parameter names for a tool have changed.
  • The number of parameters for a tool has changed.
  • Data type for a parameter has changed.
  • There are licensing issues associated with the tool.

Typically, the tools within the model that cause this type of problem are custom script and model tools rather than system tools that are installed with ArcGIS. 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 will display in a window indicating if a tool in the model is invalid or cannot be run.