Skip To Content

What's new in ArcGIS Server 10.8 and 10.8.1

ArcGIS Server 10.8 and 10.8.1 offer new enhancements, tools, and bug fixes. For a list of issues that were fixed at 10.8.1, see the 10.8.1 Issues Addressed List.


If you are upgrading to 10.8.1 from 10.7.1 or earlier, you need to reauthorize your software with a new authorization file for 10.8.1. This isn't necessary if you're upgrading from 10.8. You can access your authorization files in My Esri.

It's recommended that you review the deprecation notice to determine if your hardware and software components are still compatible with version 10.8.1 and to see a list of functionality that has been deprecated.

Upgrades are not supported from ArcGIS Server 10.2.2 or earlier versions to 10.8.1. To upgrade your ArcGIS Server site to 10.8.1, you must first upgrade it to version 10.3 or later; then upgrade it again to 10.8.1.

New features and developments in 10.8.1 are described in the following sections.

New at 10.8.1

At 10.8.1, ArcGIS Server Manager now provides an informational message when one or more of your ArcGIS Server role or extension licenses are about to expire. You can view the status of your licenses on the Software Authorization page. See Authorize ArcGIS Server for more information about licenses.

In ArcGIS Server Manager, you can now enable resampling on your cached map and image services. Resampling, which is disabled by default, redraws your cached service in map areas where you have not generated tiles at that scale, based on the closest level of detail generated on the server.

Learn more about resampling

A new offline workflow is available with 10.8.1 and ArcGIS Pro 2.6 for branch versioned data that allows you to synchronize your offline edits to a named branch version. A version administrator can review edits in the named branch version (also referred to as a replica version) and make corrections before posting the edits to the default version. See Work with offline maps and branch versioned data for more information.

Also new with 10.8.1 and ArcGIS Pro 2.6, you can publish a topology in a feature service that references the source data. Because you can only edit branch versioned data through a feature service, including the topology in the feature service allows you to validate the topology after editing and correct any topology errors that arise as a result of your edits.

Services using shared instances can now have custom server object extensions (SOEs) or server object interceptors (SOIs) starting at 10.8.1.

New in 10.8

The following sections describe features and changes introduced at 10.8.

Services and publishing

When you create a map in ArcMap and publish a feature service (a map service with feature access enabled) to an ArcGIS GIS Server 10.8 site, the feature service preserves the field order you define for the layers in your map.

Map services published from ArcGIS Pro now support two new parameters in the export, identify, find, and queryLegends operations:

  • clipping masks the parts of the layer that are outside of a clip polygon. The input clipping geometry must be a polygon. Clipping is supported on all layer types, including raster and TIN layers.
    Clipping example
  • spatialFilter directs the service to draw or query only those features that meet your spatial filter criteria. This is only supported on feature layers. The input geometry can be polygons, lines, envelopes, or points. All spatial relationships that are used in map and feature service queries are supported, such as Intersects, Within, and Contains.
    Spatial Filter example

The Publish Routing Services command line utility has been improved at 10.8. Routing services created by the tool provide better performance and have several new capabilities:

  • You can create service area lines along with service area polygons using the GenerateServiceAreas service. You can also specify the travel cutoff on a per facility basis when using this service.
  • The VehicleRoutingProblem service can return shapes for assigned and unassigned stops.
  • The GenerateOriginDestinationCostMatrix service can now return the OD cost matrix as a CSV file.
  • The utility can now publish services from network datasets in enterprise geodatabases, as well as from mobile map packages.

Server administration

Compatible map services published from ArcGIS Pro to ArcGIS Server 10.8 will initially use the shared instance pool by default. This only applies to new ArcGIS Server sites created at 10.8; all sites upgraded from a previous version will maintain their default publishing settings. The default instance type can be changed in Server Manager; the instance type for any individual compatible map service can be changed as well.


Services that can use the shared instance pool must be published from ArcGIS Pro as map, feature, WFS, WMS, or KML services. They can be cached services. At 10.8.1 and later, but not before, services using shared instances can have custom server object extensions (SOEs) or server object interceptors (SOIs).

Learn more about shared and dedicated instances

The underMaintenance flag for ArcGIS Server machines now affects asynchronous geoprocessing jobs. At 10.8, any machine with a property of underMaintenance=true will not receive requests for asynchronous geoprocessing jobs, in addition to other service requests. You can use the Edit Machine operation in the ArcGIS Server Administrator Directory to change this value.

The join-site command line utility for ArcGIS Server has a new option to turn on the underMaintenance flag when the machine joins a server site. If the flag is on, the site does not forward any service requests to the machine. You might select this option if you want to check whether the machine has successfully joined the site before you allow it to receive service requests.

Custom identity stores using Java or .NET are no longer supported with ArcGIS Server. You should not configure a custom identity store with your server site.

Data sources

  • New options in ArcGIS Server Manager allow the portal administrator to create data store items for existing data stores that were registered directly with a federated server. This replaces the workflow used in 10.7.1.
  • The data stores page in ArcGIS Server Manager now allows you to register private cloud storage locations on Amazon Web Services (AWS) and Alibaba. You no longer need to edit JSON in a local file to add your private cloud store URL to the list of supported regions.
  • ArcGIS now supports Oracle 19c and IBM Db2 V12 for z/OS.
  • The Workgroup database server setup files that you download from My Esri now include Microsoft SQL Server 2017 Express.

Other ArcGIS Enterprise components

See the following to find out what's new in Portal for ArcGIS, ArcGIS Data Store, and the ArcGIS REST API Services Directory: