Merge Layers (Map Viewer)

The Merge Layer tool copies features from two layers of the same feature type (point, line, or area) into a new layer.

The output is a hosted feature layer.


The City of Los Angeles wants to restore the area around the Los Angeles River by developing a new park. The park must be near the Los Angeles River but not within close proximity to existing parks or toxic release facilities. Buffers around the existing parks and toxic release facilities can be merged into a single layer using the Merge Layers tool to create an exclusion zone where a new park cannot be developed.

Usage notes

The Merge Layers tool includes configurations for input features, merge settings, and the result layer.

Input features

The Input features group includes the following parameters:

  • Input layer identifies the point, line, or polygon layer that will be overlaid.
  • Layer to merge identifies the point, line, or polygon layer that will be merged with the input layer. It must be the same geometry type as the input layer. You can choose a layer using the Layer button or use the Draw input features button to create a sketch layer to use as the input.

Merge settings

The Merge settings group includes the following parameters:

  • Merge operation specifies the operation that will be used to merge fields. By default, all the fields from the input layer and layer to merge will be copied to the output. You only need to specify fields and operations for this parameter if you don't want the default behavior applied. Merge operations are optional. You can specify one merge operation per field.

    When specifying the merge operation, you must define the following options:
    • Field—The field that will be modified.
    • Operation—The operation that will be applied to the field:



      The field will be renamed in the output. A text box will appear where the new name can be specified.


      The field will be removed from the output.


      The field names will be equivalent. Field values from the layer to merge will be copied to the matched output field. Two fields can be matched if they have the same field type.

Result layer

The Result layer group includes the following parameters:

  • Output name determines the name of the layer that is created and added to the map. The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
  • Save in folder specifies the name of a folder in My Content where the result will be saved.


Attachments from the input layers will not be included in the output layer.


Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.

This tool honors the following analysis environments:

  • Output coordinate system
  • Processing extent

    The default processing extent in Map Viewer is Full extent. This default is different from Map Viewer Classic in which Use current map extent is enabled by default.


This tool consumes credits.

Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.


The Merge Layers tool creates an output hosted feature layer with point, line, or polygon features. The type of features created depends on the input layer.

By default, all of the fields from both inputs will be copied to the output. If you specified any merge operations, the output fields will reflect those values.

Licensing requirements

This tool requires the following licensing and configurations:

  • Creator or GIS Professional user type
  • Publisher, Facilitator, or Administrator role, or an equivalent custom role


Use the following resources to learn more: