laptop and a wrench

Bug

The arcpy.env.workspace setting mistakenly references the active map layer instead of the target workspace parameter when the layer names match in ArcGIS Pro.

ArcGIS Pro
Bug ID Number BUG-000179061
SubmittedAugust 27, 2025
Last ModifiedSeptember 11, 2025
Applies toArcGIS Pro
Version found3.4.3
Operating SystemWindows OS
Operating System VersionN/A
StatusKnown Limit

Additional Information

This behavior is as designed and is a known limitation. When passing only the name of a feature class to arcpy.Describe (and other functions or tools that accept a short name), it first looks for the feature class in the layers of the map. If no layer is found, it then searches in the arcpy.env.workspace. Many tools, functions, and user workflows are dependent on the software behaving this way. The documentation is updated to better represent this expected behavior. The best practice when writing scripts is to pass through the fully qualified path of the object to the function or tool. The path can be built from prior pieces of code: path = os.path.join(arcpy.env.workspace, ds, fc) arcpy.Describe(path)

Workaround

Use best practices when writing scripts by passing through the fully qualified path of the object to the function or tool. The path can be built from prior pieces of code: path = os.path.join(arcpy.env.workspace, ds, fc) arcpy.Describe(path)

Steps to Reproduce

Bug ID: BUG-000179061

Software:

  • ArcGIS Pro

Get notified when the status of a bug changes

Download the Esri Support App

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options