What's new in version 2.4.2

New

Guides

• Numerous updates to use Folder.add() for adding items and updating map methods
• Editing
  • Branch Versioning
    • Working with Branch Versioning
• Deep Learning
  • 3D Computer Vision
    • Point cloud object detection using SECOND
    • Point cloud classification using Point Transformer
• Content Management
  • Note: Available since July '25

    • Cloning via Offline Backups

    • Working with Item Dependencies and Data Sources

Samples

• Numerous updates to use Folder.add() for adding items and updating map methods
• Org Administrators
  • Note: Available since July '25
  • Working with an Organization-Wide Dependency Graph
• Deep Learning
  • 2D Computer Vision
    • Object Detection
      • Detecting airplanes in satellite imagery using deep learning
  • Tabular Data Forecasting
    • Leveraging TabPFN for Human Activity Recognition Using Mobile Dataset

Module Changes

arcgis.gis

• New Classes:
  • Job
    • Adds documentation for class as it is return type for Folder.add() method
• GIS
  • ENH-000155803 - Adds support for initializing users configured for multifactor authentication
  • Fixes performance issue with internal session objects created unnecessarily during initialization
  • notebook_server
    • Adds support for ArcGIS Enterprise on Kubernetes
• User
  • New properties:
    • resources - initializes a ResourceManager object for user
  • update()
    • Adds support for clearing tags by setting value to empty list or string
• UserManager
  • create()
    • New parameters:
      • use_defaults
• ContentManager
  • clone_items()
    • Modifies internal operations when cloning Dashboard item types to improve performance
• ItemTypeEnum
  • Adds support for:
    • MOBILE_BASEMAP_PACKAGE
    • MOBILE_MAP_PACKAGE
• Folders
  • get()
    • Adds ability for empty string to return the Root Folder just as None does
• Folder
  • add()
    • Adds documentation link to resulting Job object
• OfflineContentManager
  • import_content()
    • New parameters:
      • item_mapping - Adds support for mapping content in the export package to content already in the target deployment
      • search_existing_items - Adds support for choosing whether to search for items previously imported and use them instead of cloning

arcgis.gis.admin

• New Classes:
  • AboutManager
    • Provides information about each component that comprises an ArcGIS Enterprise deployment
      • Allows for high-level and in-depth inspection of each compenent. See About for full description of information available.
  • Adds support for defining the scope of a token (see Access tokens for detailed information):
    • DeveloperCredentialManager
    • DeveloperCredential
    • TokenPrivilege
• AGOLAdminManager
  • New properties:
    • developer_credentials
• PortalAdminManager
  • New properties:
    • developer_credentials
    • about
      • Adds property to provide access to new AboutManager for ArcGIS Enterprise
• UX
  • MapSettings
    • New properties:
      • basemap_gallery_3d_group
      • default_3d_basemap
• Kubernetes
  • New Classes
    • HealthCheckManager
    • SuitesManager
    • Suite
    • ReportManager
    • Report
    • ReportJob
  • SystemManager
    • New properties:
      • container_images
        • Adds support for getting the list of images that have been used to deploy applications
• System
  • New methods:
    • mismatch()
      • Adds support to monitor status of content between the system database and the indexing service
• LicenseManager
  • New properties:
    • expired_licenses
      • BUG-000178039 - Removes error messages related to expired licenses or Marketplace licenses by creating list
• SSLCertificates
  • import_server_certificate()
    • New parameters
      • import_chain

arcgis.gis.agonb

• AGOLNotebookManager
  • New properties:
    • data_access
      • Adds support for workspace management to ArcGIS Noteboooks in ArcGIS Online
• ContainerManager
  • start()
    • Updates method to run asynchronously

arcgis.gis.nb

• New classes:
  • NotebookFolder
• New enumerations:
  • DATAACCESSTYPE
    • Options for get() method to return either NoteboookFolder or NotebookFile object
• NotebookDataAccess
  • Adds support for notebooks on ArcGIS Enterprise for Kubernetes
  • New methods:
    • get()
    • get_workspace()
    • transfer()
  • New properties:
    • folders
  • Deprecated members:
    • create_folder()
    • files
    • upload()
• NotebookFile
  • New methods:
    • delete()
    • move()
    • rename()
    • transfer()
  • New properties:
    • name
  • Deprecated members:

    • erase()

arcgis.gis.workflowmanager

• WorkflowManager
  • New properties:
    • user_settings
• WorkflowManagerAdmin
  • Adds ability to manage configuration asynchronously
  • export_item()
    • Adds support for generating a mapping file when exporting a configuration with new parameters
      • save_path
      • export_mapping

arcgis.features

• FeatureSet
  • sdf
    • Improves initialization speed by updating internal checks for null geometry
• FeatureLayer
  • query()
    • Improves internal processing when length of the request extends beyond 2000 characters

arcgis.features.managers

• ParcelFabricManager
  • New methods:
    • shrink_to_seed()
    • merge_parcel_points()
• UtilityNetworkManager
  • Adds support for asynchronous processing on a number of methods, including export_subnetwork, enable_topology, disable_topology
• VersionManager
  • New methods:
    • get_by_name()
      • Improves peformance when searching for versions by name

arcgis.features.analyze_patterns

• find_outliers()
  • Updates analysis_field reference documentation parameter description to clarify requirement

arcgis.raster

• New Submodule:
  • arcgis.raster.realitymapping
    • Provides automation capabilities for functionality and concepts outlined in Reality mapping documentation

arcgis.raster.analytics

• Removes deprecated functions from Table of Contents
• manage_multidimensional_raster()
  • New parameters:
    • update_statistics
    • update_transpose

arcgis.raster.functions.RFT

• Adds support for new RFT format for local functions

arcgis.geoenrichment

• Country
  • New parameters:
    • derivative_variables - adds support for derivative variables

arcgis.geometry

• Geometry
  • New properties:
    • has_curves

arcgis.map

• Common Classes (Map and Scene)
  • New classes:
    • BasemapStylesService
    • BasemapStyle
  • BasemapManager
    • New properties:
      • basemap_styles_service
  • New enumeration:
    • Basemap Styles Enumerations
      • BasemapStyleLanguage
      • BasemapStylePlace
      • BasemapStyleWorldview

arcgis.apps

• dashboard
  • Adds notification that submodule will be removed from the 2.4.3 release. Deprecated since release 2.1.0.
• storymap
  • MapTour
    • Adds ability to read a categorized maps within a Map Tour StoryMap (no updating)
  • Map
    • New methods:
      • update_map_layers()
        • Adds support for setting layer visibility in maps
  • Collection
    • New properties:
      • content_info
    • New methods:
    • update_content_info()
      • Adds ability to set visibility of items in the Collection
  • BriefingSlide
    • New properties:
      • display-title
  • SlideLayout
    • New values:
      • provides support for Flexible layouts to Briefing Slide
        • FLEXIBLE
        • TITLELESSFLEXIBLE
  • Block
    • add_content()
      • Adds fit as the default when adding image content to a briefing slide

arcgis.learn

• Updates module to prevent future dependency Deprecation Warnings from printing upon import

• Dependency Changes:

  • Upgrade the timm dependency to 1.0.14
    • modifications to supported backbones for model initialization
  • Tensorflow has been removed as a dependency from the arcgis.learn stack

• Adds support for Satlas pretrained backbones to imagery models

• Updates to formatting for better display of parameters in ArcGIS Pro dialogs

• Adds optimization for finding learning rate (lr_find() methods)

• Data Preparation Methods

  • prepare_data()
    • Updates dataset_type documentation to indicate argument no longer required for data used with WNet_cGAN models

• Automated Machine Learning

  • AutoDL
    • Adds mean intersection over union as the accuracy metric for evaluating the best performing model for pixel classification

• Object Classification Models

  • FeatureClassifier
    • Adds support for clay and dofa backbones for vision tasks such as object classification, detection, or pixel classification
    • Adds support for GRAD-CAM for multi-label RGB and Multispectral, as well as single-label Multispectral data

• Object Detection Models

  • Adds support for clay backbones with vision transformer detection for improved performance to FasterRCNN, MaskRCNN, SingleShotDetector, HEDEdgeDetector and DeepLab models
  • RetinaNet
    • New parameters:
      • Adds keyword arguments table with wavelengths parameter

• Pixel Classification Models

  • New models:
    • Hyperspectral3DRCNet

• Image Translation Models

  • ImageCaptioner
    • Removes fastext from model
    • Removes option of teacher_forcing and dropout keys on decoder_params keyword argument

• Feature, Tabular, and Timeseries models

  • MLModel
    • Adds support for encoding location attribute
    • fairness_score()
      • Adds documentation regarding support of binary classification only
      • Updates documentation with parameter tables for initilization, fairness_score(), and initialize_fair_model()
  • TimeSeriesModel
    • Adds support for the TimeMoE architecture

• Inferencing Methods

  • classify_objects
    • Adds support to enable explainability map for multi-label RGB and Multispectral, as well as single-label Multispectral data
  • Embeddings
    • Adds support for encoding location attribute

• Model Management

  • train_model()
    • Adds support for multi-label RGB and Multispectral, as well as single-label Multispectral data

arcgis.datapipelines

• New documentation:
  • PipelineRun
• run_data_pipeline()
  • Adds note about supported platform only being ArcGIS Online

Fixes

Guides

• Deep Learning
  • 2D Computer Vision
    • Other Imagery Topics
      • How Image Captioning Works - removes trained embeddings from
• Spatially enabled dataframe
  • Visualizing - updates to popup rendering and initialization step

Samples

• Org Administrators
  • Clone a group - Updates to how item is added
• Deep Learning
  • 2D Computer Vision
    • Object Classification
      • Feature Categorization using Satellite Imagery and Deep Learning - adds GRAD-CAM explainability mapping
    • Using Pre-trained Models
      • Count Cars in Aerial Imagery Using Deep Learning - narrative updates, additional batch images, and display of time and chart for
  • 3D Computer Vision
    • Remove Setting up the environment sections:
    • Point cloud classification using PointCNN
    • [Point cloud classification using RandLA-Net])python/latest/guide/point-cloud-classification-using-randlanet/)
    • [Point cloud classification using SQN])python/latest/guide/point-cloud-classification-using-sqn/)

Module Changes

arcgis.gis

• GIS
  • Fixes issue when value entered for url argument had a trailing slash, it caused subsequent operations to fail with double slashes in the url
  • notebook_server
    • Fixes issue with malformed urls when accessing Notebook Server configured for ArcGIS Enterprise on Kubernetes
    • Fixes issue where blank list returned if server licensed as Notebook Server was licensed as other roles
• Item
  • Fixes issue where mosaic rule not recognized when rendering item in notebooks
  • attachments_size
    • Fixes issue where property returned None
  • remap_data
    • Fixes permissions error when attempting to remap data in a cloned item
  • publish()
    • Fixes issue where spk and slpk items failed to publish because request was not accommodating cache correctly
    • Fixes issue where tpk items failed to publish layer content in ArcGIS Online
    • Fixes issue on spk items where published output returns Unable to access layer settings message and does not render
    • Fixes issue where tpk items failed to publish if publish_parameters argument provided but build_initial_cache is not
  • create_tile_service()
    • Fixes Job Failed error when run on hosted feature layer item
  • snapshots
    • Fixes KeyError caused by misspelling internally
  • usage()
    • BUG-000174862 - Fixes incorrect response on a hosted tile layer item
• ContentManager
  • clone_items()
    • BUG-000172746 - Fixes issue when cloning hosted feature layers resulted in different item id for cloned feature service and cloned feature service
    • BUG-000176566 - Fixes issue when cloning a Dashboard with a category selector resulted in a dashboard whose category selector did not work
    • BUG-000176634 - Fixes "Cannot open map" error on cloned Dashboard if source Dashboard contained a Map Element in Mobile View
    • BUG-000174859 - Fixes issue with cloning Survey123 Form items multiple times in succession with preserve_item_id=True
    • BUG-000173240 - Fixes issue when cloning a folder with Survey123 Form item results in incorrect version changes in cloned form definition
    • Fixes Public Repo Issue #2244 when cloning hosted feature layer items that had views created and no attibute domains
    • Fixes issue where WebExperience and StoryMap urls were not formed correctly in target content
    • Fixes Public Repo Issue #1835 where source code to check hosted Feature Layer service name and only create new one if identical service name is unavailable in target
    • Fixes issue when cloning Web Experience Template item types and using the preserve_item_id argument not working
    • BUG-000178647 - Fixes issue of incorrectly updating the sytleUrl for vector tile layers when using the item_mapping argument to map between vector tile layers during clone of Web Map items
  • replace_service()
    • BUG-000171239 - Updates reference documentation to indicate that the item extent is always updated to the replacement item's extent
• Folder
  • add()
    • Fixes issue where item tags entered as strings were overwriting existing tags instead of updating
    • BUG-000176760 - Fixes return type documentation and internal code processing
    • Fixes issue where item_id argument was not used properly on ArcGIS Enterprise
• Group
  • update()
    • BUG-000174312 - Fixes issue where could not remove all the tags for a group
• UserManager
  • create()
    • Fixes issue where thumbnail argument was not being read properly
    • Fixes issue in ArcGIS Online and ArcGIS Enteprise for Kubernetes where group argument was not recognized
• User
  • reassign_to()
    • BUG-000177925 - Fixes issue where method returns True even for invalid target_username argument
• OfflineContentManager
  • export_items()
    • Fixes issue with importing feature layer views that were created from feature layers sourced by a feature layer
    • Fixes issue where WebExperience and StoryMap urls were malformed in imported content
  • import_content()
    • Updates missing documentation for item_mapping parameter
• ItemProperties
  • Fixes issue where the categories list was being converted to a string before sending request causing failure to upload categories correctly
• ViewManager
  • update()
    • Fixes issue where view was not updated with correct ViewLayerDefParameter object properties

arcgis.gis.admin

• Kubernetes
  • DeploymentManager
    • Adds missing documentation
    • search()
      • Fixes AttributeError: 'NoneType' object has not attribute 'post' error when calling method
  • DeploymentProperty
    • Adds missing documentation
• SSLCertificates
  • update()
    • BUG-000179071 - Fixes issue where missing information was not sent in request

arcgis.gis.agonb

• AGOLNotebookManager
  • snapshots
    • Corrects misspelling in documentation and internal code

arcgis.gis.nb

• MachineManager
  • delete_certificate()
    • Fixes error with how the web request was sent to the server

arcgis.gis.tasks

• Fixes issue when getting properties for submodule objects
• TaskManager
  • all
    • Fixes AttributeError: 'NoneType' object has not attribute id when retrieving all tasks

arcgis.features

• FeatureLayer
  • query()
    • Fixes performance issue when the result_record_count argument is larger than total number of features satistying query
    • Fixes incorrect results when using out_statistics and group_by_fields_for_statistics arguments together
    • Fixes Pydantic ValidationError when using a valid order_by_fields argument
    • Fixes failure when using the geometry_filter argument and url for request exceeds 2000 characters
• FeatureLayerCollection
  • Fixes issue where active gis was not being passed correctly into the initialization
• Spatially Enabled DataFrame (GeoAccessor)
  • project()
    • Fixes failure to project data when spatial reference added as a dictionary
    • BUG-000178191 - Fixes failure to properly project data in environments that do not have ArcPy
  • sr
    • Improves performance issue when setting value
  • from_featureclass()
    • Fixes error when initializing object from shapefile item in ArcGIS Online
    • Fixes error when location argument is an arcpy.mp.Layer object if layer's source is a web feature layer
    • Fixes KeyError issue with Shape_Length and/or Shape_Area columns processed incorrectly internally
  • to_feature_collection()
    • Fixes failure to render when new geometry is being set, for example rendering buffers of points
  • compare()
    • BUG-000177928 - Fixes TypeError: '<' not supported between instances of 'Geometry' and 'Geometry' when running method
  • to_featureclass()
    • BUG-000171047 - Fixes issue where resulting attribute data types did not match the source attribute data types
  • to_table()
    • Removes Pandas warning about Series.dt.to_pydatteime()

arcgis.features.managers

• FeatureLayerCollectionManager
  • create_view()
    • Fixes issue in ArcGIS Online where interal ID value was not passed to request correctly
• AttachmentManager
  • add()
    • BUG-000174280 - Fixes issue when adding files larger than 10MB in ArcGIS Enteprise 11.4 and 11.5
  • get_list()
    • Fixes Public Repo Issue #2269 where method did not return attachments from the correct version

arcgis.raster

• ImageryLayer
  • refresh_service()
    • Fixes ValueError: The service is not stored on a system where it can be refreshed for hosted imagery layer items

raster.analytics

• copy_raster()
  • Fixes issue where if tool failed and an item existed with the output_name argument value, the previously existing item was deleted

arcgis.raster.functions

• raster_collection_function()
  • Fixes failure when using a Process Raster Collection RFT object in function

arcgis.geoenrichment

• Country()
  • enrich
    • Fixes RequestException errors when using notebooks in Notebook Server with IWA authentication

arcgis.geometry

• Geometry
  • as_shapely()
    • Fixes Public Repo Issue #2211 where multipolygon features did not render properly
  • is_multipart
    • Fixes Public Repo Issue #2354 where property returned False when should return True

arcgis.geometry.functions

• lengths()
  • Fixes Public Repo Issue #2325 and BUG-000178221 - Clarifies documentation on data types required for the units argument
• buffer()
  • BUG-000179671 Fixes TypeError when trying to get the extent of resulting geometries when inputs had curves
• intersect()
  • BUG-000179297 Fixes AttributeError: 'Polyline' object has no attribute 'paths' when using geometry created with curvePaths

arcgis.layers

• Deprecated classes:
  • BasemapServices
  • BasemapService
• Working with Map Service Layers
  • EnterpriseVectorTileLayerManager
    • Fixes BUG-000177757 AttributeError: 'Layer' object has no attribute stop when calling stop(), edit(). or start() methods
• Working with OGC Layers
  • Provides support for both Esri OGC and non-Esri OGC collections
  • Updates classes for modern OGC formats
  • Fixes Public Repo Issue #2304 where internal assert statements blocked initialization of objects from valid OGC servers

arcgis.map

• Map Classes
  • MapContent
    • add()
      • Fixes issue where mosaic rules were not recognized when rendering item

arcgis.apps

• storymap
  • Storymap
    • credits()
      • Fixes issue where credits would display in the wrong position relative to heading and description
• itemgraph
  • create_dependency_graph()
    • Fixes issue where method included items from outside organization when it should not
  • load_from_file()
    • Fixes intermittent 403 errors so that operation completes even broken items exist within the file
• survey123
  • Survey
    • publish()
      • Fixes 400 Error regarding invalid definitions for EditorTrackingInfo when publishing a new survey
      • Fixes error when publishing across multiple organizations
    • generate_report()
      • BUG-000179345 - Fixes issue where running method once works, but running after that returns None

arcgis.learn

• Fixes documentiaon error on load() method of various models that incorrectly stated paths to DLPK files could be used
• Fixes incorrect warning message to install older version of gdal
• Handles the ImageSpaceUsed key in Esri model definition files for test-time augmentation operations
• Data Preparation Methods
  • prepare_data()
    • Fixes AttributeError module 'numpy' has no attribute 'product' for 3D dataset_type arguments
  • estimate_batch_size()
    • Fixes performance issues with CPU/RAM in eval mode
• Automated Machine Learning
  • AutoML
    • Fixes error when training using explanatory_variables or variable_predict
    • predict()
      • Fixes issue where list of importance factors included indirect variables when setting name for output importance table
      • Fixes Exception when used with a trained model using a multimodal image and text combined with location embeddings
      • Fixes TypeError when model initialized using from_model() on older models
      • Fixes execution error resulting from failure to get predictions from a trained model because of Pandas NA values
  • ImageryModel
    • load(()
      • Fixes FileNotFoundError when when using a dlpk and databunch object
• Object Classification Models
  • FeatureClassifier
    • Fixes TypeError about keyword argument default_cfg when initializing object using hf backbones
    • transformer_backbones()
      • Fixes situation where only timm backbones were being returned
    • show_results()
      • Fixes IndexError when using gradcam and rows argument exceeds the batch_size of the data used to initialize the model before training
• Object Detection Models
  • SingleShotDetector
    • Fixes GIS login error when initializing with Clay backbones
  • MaskRCNN
    • fit()
      • Fixes issue when training RGB imagery data greater than 8-bit
• Pixel Classification Models
  • DeepLab
    • Fixes TypeError about keyword argument default_cfg when initializing object using satlas backbones
  • MaXDeepLab
    • Fixes NameError on show_batch() and show_results() caused by missing dependencies
  • MMSegmentation
    • Fixes TypeError failure on initialization with prithvi100m model
• Image Translation Models
  • CycleGan
    • lr_find()
      • Fixes RuntimeError because of expected match between input type and bias type
  • Pix2Pix
    • lr_find()
      • Fixes OutOfMemory error using data object set with batch_size not set
  • SuperResolution
    • lr_find()
      • Fixes OutOfMemoryError when run on a model initialized from data with a batch_size not set
  • ImageCaptioner
    • bleu_score()
      • Fixes AttributeError: 'float' object has not attribute 'item' when running method
• 3d Models
  • MMDetection3D
    • Fixes issue where generic error is raised when more detailed message about Voxel size being too large should be returned
  • PTv3Det
    • predict_h5()
      • Fixes AttributeError: 'InstanceData' object has not attribute 'bboxes_3d' error when run against PointCloud OD datasets
      • Fixes IndexError when the detect_thresh argument is set to 0.0
• Object Tracking Models
  • SiamMask
    • fit() and show_results()
      • Fixes ValueError failure on both methods caused by NumPy and OpenCv format incompatibility
• Feature, Tabular, anad Timeseries models
  • MLModel
    • predict()
      • Fixes failure when explain=True while using gradient booster model_type
    • save()
      • Fixes AttributeError about fairness_label_encoder after running bias mitigation operations
• Raster Time Series Models
  • ClimaX
    • Fixes NameError during initialization error with compatible backbones
  • PSETAE
    • fit()
      • Fixes issue where no metrics were being written to output file when saving trained model
    • lr_find()
      • Fixes OutOfMemoryError when run on a model initialed with a batch_size=None
• Unstructured Text Models
  • Fixes performance and truncation issues with longer text input
  • arcgis.learn.text module
    • Fixes AttributeError: 'TextDataObject' has no attribute train_dl` error when initializing objects
    • EntityRecognizer
      • extract_entities()
        • Fixes issue with address tag raising KeyError: 'Address' when running method
    • TextClassifier
      • predict()
        • Fixes error log being produced in output despite the method executing correctly
• Inferencing Methods
  • classify_objects
    • Fixes issue where no grad-cam visualization is created if input_features is not provided
    • Fixes execution failure when running functions with test time augmentation and explainability map (GRAD-CAM)
  • Embeddings
    • visualize()
      • Fixes ValueError when using image and more than 2 clusters
• Model Management
  • AIServiceConnection
    • get_dict()
      • Fixes failure because of mishandling object initialized with empty secret parameters