Skip to content

update deprecations and removals for 2.4.2 #2387

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 13, 2025
Merged

update deprecations and removals for 2.4.2 #2387

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4d498fd
update deprecations and removals for 2.4.2
jyaistMap Oct 11, 2025
f8a77ab
Merge 'upstream/next' into jy-dep-notices-242
jyaistMap Oct 11, 2025
7a42f14
sync with recent changes to resolve conflicts
jyaistMap Oct 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
124 changes: 69 additions & 55 deletions guide/02-api-overview/deprecation-notices.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,17 +13,25 @@
"\n",
"These classes, functions, and modules in the ArcGIS API for Python are deprecated and may cause compatibility issues in future versions:\n",
"\n",
"### `arcgis.gis` Module\n",
"\n",
"- `ContentManager.add` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.add` instead.\n",
"- `ContentManager.create_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `gis.content.folders.create` instead.\n",
"- `ContentManager.delete_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.delete()` instead.\n",
"- `ContentManager.rename_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.rename()` instead.\n",
"- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n",
"- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
"- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
"- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
"- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release.\n",
"- `UserManager.create` - the `level` parameter is depreacted at **2.4.0** and will be removed from the method signature in a future release. \n",
"\n",
"### `arcgis.apps` Module \n",
"\n",
"- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module may be removed at a future major release\n",
"- `WebExperience.clone` - deprecated in **2.3.0** will be removed in **2.4.2**. Pass in the Web Experience item to `gis.content.clone_items()` instead.\n",
"- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module will be removed at **2.4.3**.\n",
"- `StoryMap.get` - deprecated in **2.2.0** will be removed in **2.4.2**. `get` method has been deprecated, use `content_list` property instead.\n",
"- `StoryMap.nodes` - deprecated in **2.2.0** removed in **2.4.0**. The `nodes` property has been deprecated, use `content_list` property instead.\n",
"- `StoryMap.cover_date` - deprecated in **2.4.0** removed in future major release. Use the `date` property in the Cover class.\n",
"- `StoryMap.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n",
"- `StoryMap.navigation` - deprecated in **2.4.0** removed in future major release. Use the Navigation class.\n",
"- `Briefing.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n",
"- `Collection.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n",
"- `Swipe.properties` - deprecated in **2.4.0** removed in future major release. Use the `content` property instead.\n",
"- `Swipe.edit` - deprecated in **2.4.0** removed in future major release. Use the `content` property setter instead.\n",
"- `MapAction` - deprecated in **2.4.0** removed in future major release. Use the `MediaAction` class instead.\n",
Expand All @@ -35,34 +43,48 @@
"- `UtilityNetworkManager.trace` - deprecated the \"result_type\" parameter at **2.4.1**. Please use \"result_types\" instead.\n",
"\n",
"### `arcgis.learn` Module\n",
"\n",
"- `categorize_features` - deprecated in **1.7.1** and will be removed in a future major release (For example: 2.x to 3.x). Please use `arcgis.learn.classify_objects` instead.\n",
"- `tensorflow` - deprecated in **2.4.1** and will be removed from a future release of the *arcgis* package\n",
"\n",
"### `arcgis.gis.agonb` Module \n",
"\n",
"### `arcgis.gis.nb` Module \n",
"- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n",
"- `NotebookDataAccess.create_folder` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFolder.create_folder()` instead.\n",
"- `NotebookDataAccess.files` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFolder.files` instead.\n",
"- `NotebookDataAccess.upload` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFile.upload()` instead.\n",
"- `NotebookFile.erase` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFile.delete()` instead.\n",
"\n",
"### `arcgis.gis.nb` Module \n",
"### `arcgis.layers` Module\n",
"- `BasemapServices` - deprecated in **2.4.2**, removed in future release. Use `arcgis.map.BasemapStylesService` instead\n",
"- `BasemapService` - deprecated in **2.4.2**, removed in future release. Use `arcgis.map.BasemapStyle` instead.\n",
"\n",
"- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n",
"## Deprecation Removals\n",
"\n",
"### `arcgis.gis` Module\n",
"Several classes, functions, and methods have been completely removed from the ArcGIS API for Python. This means your code relying on them will no longer function properly. For a smooth transition, consult the API documentation to find alternative approaches and update your code accordingly.\n",
"\n",
"- `ContentManager.add` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.add` instead.\n",
"- `ContentManager.create_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `gis.content.folders.create` instead.\n",
"- `ContentManager.delete_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.delete()` instead.\n",
"- `ContentManager.rename_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.rename()` instead.\n",
"- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n",
"- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
"- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
"- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n",
"- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release.\n",
"- `overwrite` item_property on `Folder.add` is deprecated and will be removed at **2.4.2**. Use `item.update` to update the source file for an `Item` instead.\n",
"### `arcgis.geoanalytics` Module \n",
"\n",
"**The entire geoanalytics module has been deprecated on ArcGIS Enterprise and removed at ArcGIS Enterprise 11.4. If you need the geoanalytics modules, please use version 2.3.x or prior.**\n",
"\n",
"See [ArcGIS GeoAnalytics for Server Deprecation Notice](https://www.esri.com/arcgis-blog/products/geoanalytics-server/announcements/deprecation-notice-for-arcgis-geoanalytics-server/) for further details. Support for the arcgis.geoanalytics module will continue to be provided through the built-in Python API included with ArcGIS Enterprise 11.3 and earlier installations.\n",
" \n",
"- `analyze_patterns` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `data_enrichment` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `find_locations` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `manage_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `summarize_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `use_proximity` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
"- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
"- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
"\n",
"\n",
"### `arcgis.mapping` Module\n",
"The entire module was deprecated in **2.4.0** and has been removed in **2.4.2**. Install the `arcgis-mapping` package and use the `arcgis.map` module instead.\n",
"\n",
"- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n",
"- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n",
"- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n",
"- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n",
"- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n",
"- `MapImageLayer` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayer` class instead.\n",
"- `MapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayerManager` class instead.\n",
"- `EnterpriseMapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.EnterpriseMapImageLayerManager` class instead.\n",
Expand Down Expand Up @@ -91,43 +113,13 @@
"- `OGCCollection` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCCollection` class instead.\n",
"- `OGCFeatureService` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCFeatureService` class instead.\n",
"\n",
"## Deprecation Removals\n",
"\n",
"Several classes, functions, and methods have been completely removed from the ArcGIS API for Python. This means your code relying on them will no longer function properly. For a smooth transition, consult the API documentation to find alternative approaches and update your code accordingly.\n",
"\n",
"### `arcgis.geoanalytics` Module \n",
"\n",
"**The entire geoanalytics module has been deprecated on ArcGIS Enterprise and removed at ArcGIS Enterprise 11.4. If you need the geoanalytics modules, please use version 2.3.x or prior.**\n",
"\n",
"See [ArcGIS GeoAnalytics for Server Deprecation Notice](https://www.esri.com/arcgis-blog/products/geoanalytics-server/announcements/deprecation-notice-for-arcgis-geoanalytics-server/) for further details. Support for the arcgis.geoanalytics module will continue to be provided through the built-in Python API included with ArcGIS Enterprise 11.3 and earlier installations.\n",
" \n",
"- `analyze_patterns` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `data_enrichment` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `find_locations` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `manage_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `summarize_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `use_proximity` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n",
"- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
"- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
"- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n",
"\n",
"\n",
"### `arcgis.mapping` Module\n",
"- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n",
"- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n",
"- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n",
"- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n",
"- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n",
"\n",
"\n",
"### `arcgis.geocoding` Module\n",
"- `suggest` - The **distance** parameter is deprecated and removed at **2.4.0**. The parameter is no longer supported. Please use the `search_extent` parameter instead to control the search area.\n",
"\n",
"### `arcgis.widgets` Module\n",
"- `MapView` - removed in **2.4.0**. Use either `arcgis.map.Map` or `arcgis.map.Scene` instead.\n",
"\n",
"### `arcgis.gis.server` Module\n",
"\n",
"- `Mode.update` - deprecated in **1.7.1** removed in **2.4.0**. Use `Mode.update_mode` instead.\n",
"\n",
"### `arcgis.gis.admin` Module\n",
Expand All @@ -140,9 +132,11 @@
"- `UX.default_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n",
"- `UX.vector_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n",
"\n",
"### `arcgis.gis.agonb` Module \n",
"- `Container.terminate` - deprecated in **2.3.0**. Removed in **2.4.0**. Use `Container.shutdown` instead.\n",
"\n",
"### `arcgis.raster` Module\n",
"\n",
"- `calculate_distance` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation (or arcgis.raster.functions.gbl.distance_allocation for allocation output) instead.\n",
"- `calculate_travel_cost` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation (or arcgis.raster.functions.gbl.distance_allocation for allocation output), instead.\n",
"- `cost_allocation` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation instead.\n",
"- `cost_backlink` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation with value specified for output_back_direction_raster_name, instead.\n",
Expand Down Expand Up @@ -172,7 +166,27 @@
"\n",
"### `arcgis.gis` Module\n",
"\n",
"- `Group.invite_by_email` - deprecated in **1.5.1** removed in **2.4.0**. Use `Group.invite` instead."
"- `Group.invite_by_email` - deprecated in **1.5.1** removed in **2.4.0**. Use `Group.invite` instead.\n",
"- `Folder.add()` - `overwrite` item_property is removed at **2.4.2**. Use `item.update` to update the source file for an `Item` instead.\n",
"- `ContentManager.dependency_manager` - removed in **2.4.2**.\n",
"- `arcgis.gis.sharing` Submodule\n",
" - `DependencyManager` removed in **2.4.2**. \n",
"\n",
"### `arcgis.apps` Module\n",
"- `arcgis.apps.storymap` Submodule\n",
" - `StoryMap.get()` removed at **2.4.2.**\n",
" - `StoryMap.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n",
" - `StoryMap.navigation` - deprecated in **2.4.0** removed in **2.4.2**. Use the Navigation class.\n",
" - `Briefing.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n",
" - `Collection.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n",
"- `arcgis.apps.expbuilder` Submodule\n",
" - - `WebExperience.clone` - Removed in **2.4.2**. Pass in the Web Experience item to `gis.content.clone_items()` instead. \n",
"\n",
"### `arcgis.learn` Module\n",
"- `TensorFlow` - removed as dependency in **2.4.2**.\n",
"\n",
"## Dependencies\n",
"- `fiona` removed as a dependency in **2.4.2**."
]
}
],
Expand Down