# Merge Geometry

# Manual

# Merge Geometry Widget 

## Overview

This widget merges geometries and edits feature attribute properties within ArcGIS Experience Builder.

## Getting Started

### Installation

Select the widget in the Experience Builder canvas to open the configuration panel on the right.

### Configuration

The configuration panel has three sections:

![config panel](https://docs.hanoit.com/uploads/images/gallery/2026-03/vJGBzHb2mvBdAyYP-image-1774804420437.png)

1. License Configuration
2. Map settings
3. Layers settings

### License Configuration

To activate the widget license:
![Config licence option](https://docs.hanoit.com/uploads/images/gallery/2026-03/VMF72VKPO5kHiyww-image-1774848634118.png)


1. In the right panel, click **Configure Licence**.
2. Enter your license key in the input field.
3. Click **Validate**.

Once validated, the widget is fully functional.

### Select Map Widget
[![Config map widget](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/s6JBmbwdJa7FdqoF-image-1774848934936.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/s6JBmbwdJa7FdqoF-image-1774848934936.png)


In **Select Map Widget**, open the dropdown *(1)* and choose the map *(2)* to use with this widget.

### Select Layers
[![Config select layers](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/iDi1zzSIudE0nd0G-image-1774848987144.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/iDi1zzSIudE0nd0G-image-1774848987144.png)

[![Config select layers](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/VKEeaLLhyh1qk4nk-image-1774849005812.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/VKEeaLLhyh1qk4nk-image-1774849005812.png)



In **Select Layers**, the layer list *(1)* lists layers available in the published app. Enable or disable layers *(3)* for merge operations. Use the quick-select tool *(3)* to select layers faster.

## Usage

### Layer Selection Screen

The first screen shows the layer selection. Only layers configured in the Configuration section are listed.


[![Operation screen: select Layer](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/rW13kiJ85sbDSR7q-image-1774849049763.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/rW13kiJ85sbDSR7q-image-1774849049763.png)


### Operations Screen

After selecting a layer, the operations screen shows:

- **Selection tools** *(1)*
- **Operation type** *(2)*
- **Selected features list** *(3)*
- **Attribute edit form** *(4)*
[![operation Screen: feature selection](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/ujQyjAUKLqnBuaUv-image-1774849095137.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/ujQyjAUKLqnBuaUv-image-1774849095137.png)


### Selection Tools

Three selection tools are available:

[![Selection tools](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/bQZ18MbVV6H1yM2t-image-1774849146062.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/bQZ18MbVV6H1yM2t-image-1774849146062.png)


| Tool | Description |
|------|-------------|
| *(1)* | Point |
| *(2)* | Rectangle |
| *(3)* | Polygon |




> - Hold **Shift** to add features to the selection.
> - Hold **Ctrl** to remove features from the selection.
> - The red button clears all selected features.



### Operation Type

[![Operation type](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/u1VFuVDSjNK72gCw-image-1774849999964.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/u1VFuVDSjNK72gCw-image-1774849999964.png)


| Operation | Description |
|-----------|-------------|
| **Existing Feature** | Merges selected features and appends the result to a previously selected feature. |
| **New Feature** | Creates a new feature from the merged geometry. |

### Selected Features


[![Selected features](https://docs.hanoit.com/uploads/images/gallery/2026-03/scaled-1680-/1ReZyAli82hadRDT-image-1774850028347.png)](https://docs.hanoit.com/uploads/images/gallery/2026-03/1ReZyAli82hadRDT-image-1774850028347.png)


This section lists features selected with the selection tools. You can:

- Remove individual features.
- For **Existing Feature**, choose the target feature that will receive the merged geometry and updated attributes.