Create Topology (Data Management)

Available with Standard or Advanced license.


Creates a topology. The topology will not contain any feature classes or rules.

Use the Add Feature Class To Topology and the Add Rule To Topology tools to add feature classes and rules to the topology.


  • If the Cluster Tolerance parameter is blank or set to 0, the xy tolerance of the feature dataset which contains the topology will be used.

  • There is a range allowed for the cluster tolerance value, this range is derived from the precision of the spatial reference of the feature dataset in which the topology is contained. If the value entered is larger than the maximum cluster tolerance, the maximum value will be used instead. If the value entered is smaller than the minimum, the minimum value will be used.


CreateTopology(in_dataset, out_name, {in_cluster_tolerance})
ParameterExplanationData Type

The feature dataset in which the topology will be created.

Feature Dataset

The name of the topology to be created. This name must be unique across the entire geodatabase.


The cluster tolerance to be set on the topology. The larger the value, the more likely vertices will be to cluster together.


Derived Output

NameExplanationData Type

The output topology.


Code sample

CreateTopology example (stand-alone script)

The following stand-alone script demonstrates how to use the CreateTopology function.

# Name:
# Description: Creates a new topology (these must reside within a feature dataset)

# Import system modules
import arcpy
arcpy.env.workspace = "h:/workspace"
arcpy.CreateTopology_management("d:/landuse.gdb/landuse", "landuse_Topology")


This tool does not use any geoprocessing environments.

Licensing information

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

Related topics