---
alias: user-guide-set-material-substrate-map
description: "This documentation details associating a material with a substrate map through a wizard process"
---

# Set Material Substrate Map

:lock: Material.**SetSubstrateMap**

## Overview

This operation is used to associate a **Material** with a **Substrate Map**.

## Setup

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

## Preconditions

* The Mapping module must be properly licensed in the system.
* The **Material** must be Active and Non-Template.
* The **Material** must not already have a **Substrate Map**.

## Sequence of Steps

The **Set Substrate Map** wizard is called from the Details page of the selected **Material**. Depending on the current system status, the **Set Substrate Map** button may be visible on the top ribbon or under the **More** actions button.

### Step 1: General Data

1. Select the **Material** you need.
2. Under **Mapping**, select **Set Substrate Map** to open the wizard.
3. You have the following options to set the **Material** with:

      * **Substrate Map** – you must specify an existing **Substrate Map**.
      * **Product Substrate Map Template** – if the associated Product Version has a **Substrate Map** set, it will use the current **Material** Product template.
      * **File** – you must specify an existing file, which must be a well-formed **E142** file containing a single reference to the current **Material** as a substrate in the Substrates section of the file.

4. Optionally, **Synchronize Quantity** – when enabled, the quantity of the **Material** is synchronized to match the total number of units defined in the selected **Substrate Map**.
5. Optionally, enter a comment.
6. Select **Set** to complete the operation.

    ![Screenshot showing a substrate map with various labels and symbols, including "Set", "Substrate Map", and queue numbers.](images/substrate_map_set_01.png)

### Step 2: Synchronization

1. Depending on your previous configurations, and if you chose to synchronize the **Material** with the **Substrate Map**, the following may apply:

      * If more than one Layout Specifier exists for the provided Substrate in the collection of Substrate Maps of the selected Substrate Map Payload, you must specify which Layout Specifier to use.
      * If for the specified Layout Specifier (or the single Layout Specifier if there is only one), there are more than one possible Overlay Maps, you must specify the Overlay Map to use by providing the Map Name.
      * If the **Substrate Map** has an Active Bin Code Map, the system will pre-select the Active Bin Code Map Layout Specifier and the Overlay Map. For more information, see [[user-guide-create-substrate-map-overlay]].
      * If the **Material** has Secondary Units, you must specify which Substrate Map Units to synchronize: the Primary Units or Secondary Units – always by name of the units.
      * The GUI should present the quantity of units that exist in the Map as well as the delta to the Material Quantity matching units to synchronize.
      * Optionally, specify a Loss/Bonus Reason to account for negative/positive delta(s).

    !!! note
	      You can define the default value for the Synchronize option by editing the entry Context = `Material.SetSubstrateMap` for the Element = `Synchronize` in the [[guielementdefaultvalue-gt]] Generic Table.

2. Optionally, enter a comment.
3. Select **Set** to complete the operation.

    ![Screenshot showing a substrate map with various components labeled.](images/substrate_map_set_02.png)