Skip To Content

Overwrite a web layer

In addition to publishing new web layers, you can use ArcGIS Pro to overwrite existing web feature and map image layers to reflect changes to a GIS resource or its source data.

You can overwrite an existing web layer if all of the following are true:

  • You are signed in to your ArcGIS organization with the account that owns the web layer being overwritten. You cannot overwrite an existing web layer owned by someone else in your organization.
  • The location of the web layer being overwritten has not changed while the Overwrite Web Layer pane is open.

In addition to overwriting the content of the web layer, you can modify the item description, who the web layer is shared with, and configuration settings.

Note:

The configuration of the original web layer, including pop-ups and symbology, will be overwritten with what is authored in ArcGIS Pro. Configurations saved as part of a web map will be maintained even if the updated service contains schema changes that are not compatible with the web map configuration.

For example, you shared a web layer of United States cities and authored a web map that symbolizes the cities layer using the field name. When you overwrite the web layer with a new version of the data with the name field renamed city_name, the web map will still try to symbolize the layer using the name field even though it no longer exists and the layer will not draw.

Overwrite a web feature layer

To overwrite a web feature layer that references registered data, overwrite its associated map image layer.

  1. To overwrite a web layer, do one of the following:
    • Overwrite an existing web layer with the map and all its layers. On the Share tab, in the Share As group, click the arrow next to Web Layer Web Layer and click Overwrite Web Layer Overwrite Web Layer.
    • Overwrite an existing web layer with selected layers from the map. Select the layers in the Contents pane. Right-click the selected layers, point to the Sharing pull-right menu and click Overwrite Web Layer Overwrite Web Layer.

    The Overwrite Web Layer dialog box appears.

  2. Click the Configuration tab to modify the web layer's settings. For more information on configuring the web layer, see Configure a web feature layer.
  3. Click Analyze to check for any errors or issues. You must resolve all errors. If any issues are discovered, they appear on the Messages tab. Right-click each message to get more information, read the help for the error or warning, and access suggested fixes. Learn more about analyzing GIS resources
  4. Once validated, click Publish.

Overwrite a map image layer

  1. To overwrite a web layer, do one of the following:
    • Overwrite an existing web layer with the map and all its layers. On the Share tab, in the Share As group, click the arrow next to Web Layer Web Layer and click Overwrite Web Layer Overwrite Web Layer.
    • Overwrite an existing web layer with selected layers from the map. Select the layers in the Contents pane. Right-click the selected layers, point to the Sharing pull-right menu and click Overwrite Web Layer Overwrite Web Layer.

    The Overwrite Web Layer dialog box appears.

  2. Click the Configuration tab to modify the web layer's settings. Depending on how the map image layer is drawn, see the following on how to configure the web layer.
  3. Click Analyze to check for any errors or issues. You must resolve all errors. If any issues are discovered, they appear on the Messages tab. Right-click each message to get more information, read the help for the error or warning, and access suggested fixes. Learn more about analyzing GIS resources
  4. Once validated, click Publish.

Configuring a cached map image layer

When overwriting a cached map image layer, the configuration options are dependent on whether you choose to keep the existing cache.

  1. Click the Configuration tab.
  2. Optionally, include additional layer types and capabilities by clicking the check box next to the layer or capability. For more information, see Additional layers and capabilities.
    • Linear Referencing
    • Network Analysis
    • Version Management
    • WMS
  3. Choose whether the existing cache will be kept.

    Keep existing cache

    Your existing tiles will remain associated with your web layer, allowing you to generate new tiles at only levels of detail that you specify. This is the default option.

    Don't keep existing cache

    All existing tiles will be disassociated from your web layer and associated with an automatically generated web layer named <layer>_<timestamp>. If the existing tiles are no longer needed, they can be deleted later using Delete Map Server Cache.

  4. If you keep the existing cache, the following configuration parameters cannot be modified:

    • Tiling Scheme
    • Cache directory

  5. If you selected Don't keep existing cache, choose a Tiling Scheme that defines the scale levels, tile dimensions, and tile origin for the cache. These properties define where tile boundaries will exist and are important to match when overlaying caches. Tiling scheme options include the following:
    ArcGIS Online/Bing Maps/Google Maps

    This is the default tiling scheme. The coordinate system of the web layer is reprojected on the fly to WGS 1984 Web Mercator (Auxiliary Sphere) to ensure your web tile layer overlays with these online services. The default tile width and height is 256 by 256 pixels. Scale levels for caching range from zero to 23. When you initialize a new cache, ArcGIS Pro examines the layers in your GIS resource and selects a default tile image format for you. If your GIS resource contains only vector layers, the default is PNG. If at least one raster layer is detected, the default is MIXED.

    WGS 1984 Geographic Coordinate System, Version 2

    A tiling scheme based on the WGS 1984 Geographic Coordinate System. The coordinate system of the web layer is reprojected on the fly to WGS 1984 Geographic Coordinate System. The default tile width and height is 256 by 256 pixels. Scale levels for caching range from zero to 22. When you initialize a new cache, ArcGIS Pro examines the layers in your map and selects a default tile image format for you. If your GIS resource contains only vector layers, the default is PNG. If at least one raster layer is detected, the default is MIXED.

    Existing cached map/image service

    Use an existing hosted or ArcGIS Server web tile layer or an ArcGIS Server image service as the tiling scheme of your web tile layer. When you choose this option, the tiling scheme XML file associated with the existing service is downloaded to C:\Users\USERPROFILE\My Documents\ArcGIS\TilingSchemes\Downloaded. ArcGIS Pro will honor the parameters specified in the existing service, with the exception of antialiasing. Antialiasing options set for the application are used.

    Tiling scheme file

    Import a custom tiling scheme XML file you have created that contains your preferred scales and settings. Use the Generate Map Server Cache Tiling Scheme geoprocessing tool to create a custom tiling scheme XML file. Additional tiling scheme files can also be imported from C:\Program Files\ArcGIS\Pro\Resources\TilingSchemes. The tile image format will default to PNG if the tile image format is not defined in the tiling scheme file. ArcGIS Pro will honor the parameters specified in the tiling scheme file, with the exception of antialiasing. Antialiasing options set for the application are used.

  6. Modify the Visible Range to specify the scale levels at which tiles can be built.
  7. If you selected Keep existing cache, the Visible Range cannot be made smaller than the existing cache.

    The Tiles to create value indicates how many tiles will be built and the estimated storage required.

  8. Click Build Tiles to select which scales should have tiles built automatically after publishing. Only the scale levels specified in the Visible Range will be listed.
  9. If you selected Don't keep existing cache, optionally click the Cache directory drop-down arrow to choose the server cache directory to store the cache tiles.
  10. Optionally check the Allow clients to export cache tiles check box to allow clients to download cache tiles for offline use.
    1. Specify a value to limit how many tiles can be downloaded in a single request using the Limit export to parameter.
  11. At the top of the Configuration tab, click Configure parameters Configure parameters to access service level parameters such as Maximum records returned by server and Time zone. For a full list of parameters available, see Configure service parameters.