Skip To Content

Enable Network Topology


Enables a network topology for a utility network.

A network topology is needed for analytic operations such as tracing and network diagrams. A network topology can also be enabled to discover error features.

Learn more about how to enable a network topology


  • There are some network configuration tasks that can only be performed prior to a network topology being enabled for the first time. Ensure that these configuration tasks have been completed before enabling a network topology.

  • All utility network features classes must have a spatial index prior to enabling topology.

  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.

  • This tool should be executed when connected to the default version.

  • If the Input Utility Network is from a database connection, the connection must be established as the database utility network owner.


EnableNetworkTopology(in_utility_network, {max_number_of_errors}, {only_generate_errors})
ParameterExplanationData Type

The utility network for which the network topology will be enabled.

Utility Network; Utility Network Layer

The maximum number of errors before the process of enabling the network topology will stop, and errors will be recorded in the errors table. The default value is 10000.


Increasing the maximum number of errors value will increase the length of time to enable the topology. Setting a value higher than the default value of 10000 is not recommended.


Specifies whether to generate network errors only.

  • ONLY_ERRORSThe utility network will only be evaluated for network errors. The topology will not be enabled, and the data will not be required to be registered as versioned. This allows you to inspect and fix errors in the network until you are ready to register the data as versioned and enable the topology.
  • ENABLE_TOPOThe topology is enabled. This is the default.

Derived Output

NameExplanationData Type

The updated utility network.

Utility Network

Code sample

EnableNetworkTopology example 1 (Python window)

Enable the network topology for a utility network called MyNetwork and set the maximum number of errors to 500 using the EnableNetworkTopology tool.

import arcpy
arcpy.EnableNetworkTopology_un('MyNetwork', 500)
EnableNetworkTopology example 2 (Python window)

Only generate errors for a utility network called MyNetwork using the EnableNetworkTopology tool.

import arcpy
arcpy.EnableNetworkTopology_un('MyNetwork', '', 'ONLY_ERRORS')


This tool does not use any geoprocessing environments.

Licensing information

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

Related topics