Consolidate Toolbox (Data Management)

Summary

Consolidates one or more toolboxes into a specified output folder.

Usage

  • Tools and parameters may have been added or modified between the ArcGIS Pro version installed and the version specified for the Version parameter. The consolidation process will analyze the tool's properties in the current version against the target version and return warnings or errors. Review the warnings or errors carefully as they can indicate that the tool will produce different outputs.

Parameters

LabelExplanationData Type
Toolbox

The toolboxes to be consolidated.

Toolbox
Output Folder

The output folder that will contain the consolidated toolbox.

If the specified folder does not exist, a folder will be created.

Folder
Version
(Optional)

Specifies the target ArcGIS Pro version of the consolidated toolbox. Specifying a version allows toolboxes to be used by previous versions of ArcGIS.

  • Current versionThe consolidated folder will contain tools compatible with the current version of the ArcGIS Pro release. This is the default.
  • ArcGIS Pro 2.2 The consolidated folder will contain tools compatible with ArcGIS Pro version 2.2.
  • ArcGIS Pro 2.3The consolidated folder will contain tools compatible with ArcGIS Pro version 2.3.
  • ArcGIS Pro 2.4The consolidated folder will contain tools compatible with ArcGIS Pro version 2.4.
  • ArcGIS Pro 2.5The consolidated folder will contain tools compatible with ArcGIS Pro version 2.5.
  • ArcGIS Pro 2.6The consolidated folder will contain tools compatible with ArcGIS Pro version 2.6.
  • ArcGIS Pro 2.7The consolidated folder will contain tools compatible with ArcGIS Pro version 2.7.
  • ArcGIS Pro 2.8The consolidated folder will contain tools compatible with ArcGIS Pro version 2.8.
  • ArcGIS Pro 2.9The consolidated folder will contain tools compatible with ArcGIS Pro version 2.9.
  • ArcGIS Pro 3.0The consolidated folder will contain tools compatible with ArcGIS Pro version 3.0.
  • ArcGIS Pro 3.1The consolidated folder will contain tools compatible with ArcGIS Pro version 3.1.
  • ArcGIS Pro 3.2The consolidated folder will contain tools compatible with ArcGIS Pro version 3.2.
  • ArcGIS Pro 3.3The consolidated folder will contain tools compatible with ArcGIS Pro version 3.3.
  • ArcGIS Pro 3.4The consolidated folder will contain tools compatible with ArcGIS Pro version 3.4.
String

arcpy.management.ConsolidateToolbox(in_toolbox, output_folder, {version})
NameExplanationData Type
in_toolbox
[in_toolbox,...]

The toolboxes to be consolidated.

Toolbox
output_folder

The output folder that will contain the consolidated toolbox.

If the specified folder does not exist, a folder will be created.

Folder
version
(Optional)

Specifies the target ArcGIS Pro version of the consolidated toolbox. Specifying a version allows toolboxes to be used by previous versions of ArcGIS.

  • CURRENTThe consolidated folder will contain tools compatible with the current version of the ArcGIS Pro release. This is the default.
  • 2.2 The consolidated folder will contain tools compatible with ArcGIS Pro version 2.2.
  • 2.3The consolidated folder will contain tools compatible with ArcGIS Pro version 2.3.
  • 2.4The consolidated folder will contain tools compatible with ArcGIS Pro version 2.4.
  • 2.5The consolidated folder will contain tools compatible with ArcGIS Pro version 2.5.
  • 2.6The consolidated folder will contain tools compatible with ArcGIS Pro version 2.6.
  • 2.7The consolidated folder will contain tools compatible with ArcGIS Pro version 2.7.
  • 2.8The consolidated folder will contain tools compatible with ArcGIS Pro version 2.8.
  • 2.9The consolidated folder will contain tools compatible with ArcGIS Pro version 2.9.
  • 3.0The consolidated folder will contain tools compatible with ArcGIS Pro version 3.0.
  • 3.1The consolidated folder will contain tools compatible with ArcGIS Pro version 3.1.
  • 3.2The consolidated folder will contain tools compatible with ArcGIS Pro version 3.2.
  • 3.3The consolidated folder will contain tools compatible with ArcGIS Pro version 3.3.
  • 3.4The consolidated folder will contain tools compatible with ArcGIS Pro version 3.4.
String

Code sample

ConsolidateToolbox example 1 (Python window)

The following Python window script demonstrates how to use the ConsolidateToolbox function in the Python window.

import arcpy
arcpy.management.ConsolidateToolbox(r'C:\data\BufferPoints.tbx', 
                                    r'C:\project\Buffer_Pnts', "CURRENT")
ConsolidateToolbox example 2 (stand-alone script)

Find and create individual consolidated folders for all of the toolboxes that reside in a specified folder.

# Name: ConsolidateToolboxEx2.py
# Description: Find all the toolboxes that reside in a specified folder and 
#              create a consolidated folder for each.

# import system modules
import os
import arcpy

# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Toolboxes"

# Loop through the workspace, find all the toolboxes (.tbx), and create a 
# consolidated folder for each toolbox found using the same name as the original 
# toolbox.
for tbx in arcpy.ListFiles("*.tbx"):
    print("Consolidating " +  tbx)
    arcpy.management.ConsolidateToolbox(tbx, os.path.splitext(tbx)[0], "CURRENT")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes