---
alias: user-guide-edit-substrate-map-mask
tags:
- mapping
description: "This documentation details editing a Substrate Map Mask object’s configuration data"
---

# Edit Substrate Map Mask

:lock: SubstrateMapMask.**Edit**

## Overview

This operation is used to edit a **Substrate Map Mask** object.  

## Setup

No specific setup is required other than to meet the preconditions of the transaction.

## Preconditions

* The **Mapping** module (if part of CM MES) or **App** license (if part of an Application) must be properly licensed.
* The **Substrate Map Mask** must be Active.

## Sequence of Steps

## Edit Substrate Map Mask From a Substrate Map Mask

### Step 1: General Data

1. In the chosen **Substrate Map Mask**, select **Edit Content** on the top ribbon:

    ![Screenshot showing a Substrate Map Mask with an "Edit Content" button selected on the top ribbon.](images/edit_submap_mask_01.png)

2. Use the **Add Units** (default) and **Remove Units** buttons on the right to include or exclude units from the mask:

    ![Screenshot showing a data entry interface with fields for general information.](images/edit_submap_mask_02.png)

    !!! info
        The Add Units sets the `SetValue` to the selected unit, and Remove Unit sets the `EmptyValue` to the selected unit.

3. Select **Save** to complete the operation and save changes permanently:

    ![Screenshot showing a UI with an edit field labeled "edit submap mask 03".](images/edit_submap_mask_03.png)

## Edit Substrate Map Mask Using a File

### Step 1: General Data

1. In the chosen **Substrate Map Mask**, select **Edit** on the top ribbon:

    ![Screenshot showing a Substrate Map Mask editing interface with an "Edit" button highlighted.](images/edit_submap_mask_04.png)

2. Update the **Substrate Map Mask** by replacing the E142 XML file:

    ![Screenshot showing a Substrate Map Mask with the label "7 Coit Substrate Map Mask" and filename "edit submap mask 05".](images/edit_submap_mask_05.png)

    !!! note
        The Name of the Substrate Map Mask cannot be altered.