Overwrite a web imagery layer

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

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

• You are signed in to your ArcGIS organization with the account that owns the web imagery layer being overwritten. You cannot overwrite an existing web imagery layer owned by another member of your organization.

• The location of the web imagery layer being overwritten has not changed while the Overwrite Web Layer pane is open.

• The web imagery layer is not a hosted imagery layer.

Overwriting a web imagery layer is similar to sharing a web imagery layer. You can change most of the properties of a web imagery layer when you overwrite it, including properties of the imagery and configuration settings. You can't change the name of the service or its location (the service URL).

You can also use ArcPy to share a web imagery layer to a portal. To learn more, see Automate sharing web layers.

Overwrite a web imagery layer

This workflow explains how to overwrite a web imagery layer.

1. To overwrite a web layer, do one of the following:

   • Select the layer in the Contents pane, right-click the selected layer, point to Sharing, and click Overwrite Web Layer .

   • Right-click the data in the Catalog pane for which you want to overwrite the web imagery layer, and click Overwrite Web Layer.

   The Overwrite Web Layer dialog box appears.

2. On the Overwrite Web Layer dialog box, browse to the location of the web imagery layer in your portal, select it, and click OK.

   By default, both web imagery layers and map image layers appear on the dialog box. Use the drop-down list at the bottom of the dialog box to control the layer types that appear.

3. Read the Overwrite Web Layer message and click OK to continue.

   Caution:

   If edits were made to the web layer, the edits will be overwritten.

   The Overwrite Web Layer pane appears. On the General tab, under Item Details, the name of the web layer is displayed. This name can't be changed.

4. Under the layer name, accept the Use the item description from the web layer default option or choose the Use the item description from the dataset option.

   The default option preserves the item description of the current web layer. The other option overwrites it.

5. Optionally, modify the information in the Summary and Tags fields.

   The fields may be empty if you chose to use the item description from the table in the previous step. A summary and tags are required when sharing to an ArcGIS Enterprise 10.9 or earlier portal.

   You can use the Tags drop-down menu to select existing tags. You can enter a maximum of 128 tags.

6. Optionally, modify the information in the Categories field.

   You can assign a maximum of 20 categories.

7. Under Layer and Data Type, choose one of the following options:

   • Reference registered data—Data that is registered with the server is referenced rather than copied to the server.

   • Copy all data—All data is copied to the server.

8. Optionally, under Sharing Level, change the settings:

   • Owner—Only the owner (and organization members with privileges to view content owned by other members) can access the item. This is the default option.

   • Organization—Share your content with all authenticated users in the organization. This option is available when you are signed in with an organizational account.

   • Everyone (public)—Share your content with the public. Anyone can access and see it.

   1. Optionally, under Groups, select groups to which you belong to share your content with their members.

9. Optionally, click the Configuration tab and change settings.

   For more information, see Configure a web imagery layer.

10. Under Finish Sharing, click Analyze to review for potential problems.

    Errors and warnings are listed on the Messages tab. Right-click a message to open its help topic or take corrective action in the software. Errors must be resolved before you can share your GIS resource. Resolving warnings is recommended but not required.

    Learn more about analyzing GIS resources

11. After you have resolved errors, and optionally, resolved warnings, click Publish to share the web layer.

    To save a service definition for the web layer instead, click the Publish drop-down arrow and click Save As SD.

    Caution:

    Publishing a service definition staged to overwrite will automatically replace the existing web layer if found on the server. To avoid unintentionally overwriting existing web layers and their associated data, store these service definitions in a way that makes them distinguishable from other service definitions.

12. When the web layer is successfully published, click the Manage the web layer link at the bottom of the pane to access the web layer in your portal.

    If the web layer will be drawn from cache built automatically on the server, the web layer may not be viewable while cache generation is in progress. Click Jobs to view the cache status in the Job Status pane.