Web tool compatibility

When sharing a web tool from ArcGIS Pro to ArcGIS Enterprise, you must consider the versions of each product, as there are compatibility issues in some versions. In general, the ArcGIS Pro and ArcGIS Enterprise versions must be equivalent to ensure a web tool can be shared and used. This is recommended because some of the newer features of web tools are only supported in the more recent versions of ArcGIS Enterprise.

In addition, with each release, new system geoprocessing tools are added, and existing geoprocessing tools may be enhanced with modified and new parameters. If you publish a tool containing a system tool with modified or new parameters to an older version of ArcGIS Enterprise, you may encounter an error or warning message.

ArcGIS Pro and ArcGIS Enterprise compatibility

Although you can publish a web tool from ArcGIS Pro to earlier and later versions of ArcGIS Enterprise, using the equivalent version is recommended. If you do not have the equivalent version of ArcGIS Enterprise, publishing to a version that exceeds a minor version difference of more than two is not recommended.

The following table lists the equivalent versions of ArcGIS Pro and ArcGIS Enterprise.

ArcGIS Pro and ArcGIS Enterprise equivalency

VersionArcGIS Enterprise version

ArcGIS Pro 3.1

ArcGIS Enterprise 11.1

ArcGIS Pro 3.0

ArcGIS Enterprise 11.0

ArcGIS Pro 2.9

ArcGIS Enterprise 10.9.1

ArcGIS Pro 2.8

ArcGIS Enterprise 10.9

ArcGIS Pro 2.7

ArcGIS Enterprise 10.8.1

ArcGIS Pro 2.6

ArcGIS Enterprise 10.8.1

ArcGIS Pro 2.5

ArcGIS Enterprise 10.8

ArcGIS Pro 2.4

ArcGIS Enterprise 10.7.1

ArcGIS Pro 2.3

ArcGIS Enterprise 10.7

ArcGIS Pro 2.2

ArcGIS Enterprise 10.6.1

ArcGIS Pro 2.1

ArcGIS Enterprise 10.6

ArcGIS Pro 2.0

ArcGIS Enterprise 10.5.1

The following table lists the versions of ArcGIS Pro and ArcGIS Enterprise that can be used to share and use a web tool.

ArcGIS Pro versionArcGIS Enterprise 10.6–11.1ArcGIS Enterprise 10.5–10.5.1

ArcGIS Pro 2.1ArcGIS Pro 3.1

Supports sharing and using web tools

Supports using web tools

ArcGIS Pro 2.0

Supports sharing and using web tools

Supports sharing and using web tools

ArcGIS Pro 1.4

Supports sharing and using web tools, except tools that have an input Feature Set parameter and that are shared from ArcMap

Supports sharing and using web tools

  • Supports sharing and using web tools means that you can share web tools from the indicated ArcGIS Pro version to the indicated ArcGIS Enterprise version. You can also use web tools running on the indicated version of ArcGIS Enterprise in the indicated version of ArcGIS Pro. This applies to web tools shared from both ArcGIS Pro and ArcGIS Desktop.
  • Supports using web tools means that you can use web tools running on the indicated version of ArcGIS Enterprise in the indicated version of ArcGIS Pro, but you cannot share web tools. This applies to web tools published from both ArcGIS Pro and ArcGIS Desktop.

Version compatibility warning and error messages and solutions

When publishing a web tool to a nonequivalent version of ArcGIS Enterprise, in particular an older version, you may receive warning or error messages. If the system tool in the tool you publish is new in ArcGIS Pro, you will receive error messages when publishing to an older version of ArcGIS Enterprise. If the parameters of a system tool in the tool you publish have changed, you may receive version-related warning messages stating the certain parameters are not supported. You can still publish the tool to ArcGIS Enterprise, but running the tool may not work.

If the ArcGIS Enterprise version is older than the equivalent version of ArcGIS Pro, upgrade ArcGIS Enterprise. If upgrading ArcGIS Enterprise is not available, do one of the following to resolve the errors:

  • Only expose the parameters of the tool to publish as inputs or outputs that are supported on the version of ArcGIS Enterprise that you are publishing to. This is the preferred way.
  • If the tool was created in ArcGIS Pro 3.0 or later and uses ArcGIS Pro 3.0 or later to publish, use the Save Toolbox To Version tool to save the tool to the equivalent version of ArcGIS Enterprise. Run and publish the modified tool and publish from the ArcGIS Pro version that is the equivalent version of ArcGIS Enterprise.
  • If the tool was created in an earlier version of ArcGIS Pro, run and publish the tool from the ArcGIS Pro version that is the equivalent version of ArcGIS Enterprise.

The Save Toolbox To Version tool only applies a change to a model tool. Script tool or tools in a Python toolbox are not modified by the tool.

If a tool created in ArcGIS Pro 2.6 or 2.7 includes a parameter with a raster data type, the tool will not appear if published to ArcGIS Enterprise 10.8 or earlier. To resolve this issue, do one of the following:

  • Publish the tool to ArcGIS Enterprise 10.8.1 or later.
  • Create a tool in ArcGIS Pro 2.8 or later with the same parameters and settings and publish the tool to any version of ArcGIS Enterprise.

Sharing a web tool to ArcGIS Online is not supported. See Publish web tools in ArcGIS Pro for more information.