Replace a web tile layer

You can replace a tile layer in your ArcGIS Online portal or ArcGIS Enterprise portal (version 10.8 or later) with another tile layer. When you replace a layer, its content is updated. Its service URL and item ID do not change.

When you replace a tile layer, you specify a target layer (the layer to be replaced) and an update layer (the replacement layer). You also specify an archive layer name. When the target layer is replaced, its content is archived in your portal. Optionally, you can replace the item information of the target layer in addition to its content.

Both the target layer and the update layer must be hosted in your portal, and you must be the owner of both layers.

The benefit of this workflow is that it allows you to stage and test the update layer in your portal before you replace the target layer. When the layer is replaced, user access is uninterrupted. The archive layer is available if you need to revert the update.

The illustration below shows how properties of the target, update, and archive layers are managed:

  • The item ID of the target layer (A) does not change. By default, the archive layer uses the item ID of the update layer (B); optionally, the archive layer can be assigned a new item ID (C).
  • The service URL of the target layer (A) does not change. The service URL of the archive layer references the target layer name and appends the word "archive" and a date stamp (A_Archive). The portal no longer contains a web layer with the name or service URL of the update layer.
  • The target layer content (A) is replaced by the update layer content (B). The archive layer stores the replaced target layer content (A).

Table of target, update, and archive layer properties
Properties of the target layer, update layer, and archive layer before and after replacement are shown.

As a best practice, the update and target layers should use the same spatial reference and tiling scheme.

Note:

If you have previously used ArcMap to overwrite map services, this workflow achieves the same result more efficiently. There is no alternative workflow in ArcGIS Pro to update tile layers in your portal.

Follow the steps below to replace a tile layer.

  1. Sign in to ArcGIS Pro.

    Your active portal must be the portal in which the web layers are hosted. You must be signed in with the account that owns the layers.

  2. On the ribbon, click the Share tab. In the Manage group, click Replace Web Layer Replace Web Layer.

    The Geoprocessing pane appears and opens the Replace Web Layer tool.

  3. For Target Layer, enter the service URL or item ID of the layer you want to replace.

    You can browse to the tile layer or drag it from the catalog view or Catalog pane to the Target Layer input box. Alternatively, you can copy and paste the layer's service URL or item ID.

  4. Optionally, for Archive Layer Name, replace the default value with a new name.

    The default archive layer name is <target layer>_archive_<timestamp>.

  5. Optionally check the Create New Item For Archive Layer box.

    When the box is unchecked, the archive layer uses the item ID of the update layer. This is the default. When the box is checked, a new item ID is assigned to the archive layer and the item ID of the update layer is no longer associated with any content.

  6. For Update Layer, enter the service URL or item ID of the layer that will replace the target layer.
  7. Optionally check the Replace Item Information box.

    By default, the item information associated with the target layer is not replaced. Check the box to replace it with the update layer item information. The thumbnail image, summary, description, and tags will be replaced. The credits (attribution), terms of use, and package name from which the layer was created will not be replaced.

  8. Click Run.

    When the tool completes, the target layer is replaced by the update layer. The archive layer is stored in the folder location of the target layer.

Related topics