---
alias: user-guide-detach-material
description: "This documentation outlines the process for removing a sub-material from a parent material"
---

# Detach Material

:lock: Material.**Detach**

## Overview

This operation is used to remove a **Sub-Material** from a Main **Material**.
As a naming convention, the **Material** being detached is referred to as **Sub-Material**, and the **Material** losing the **Sub-Material** is referred to as Parent **Material**. The highest parent of the Parent **Material** is referred to as Top-Most of Parent **Material**.

## Setup

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

## Preconditions

* The Parent **Material** and the **Sub-Material** exist and are Active.
* The Top-Most **Material** is not On Hold.
* The Top-Most **Material** property CurrentMaterialTransfer must be empty.
* For the Top-Most of the Parent **Material**:
    * The In Transfer Order Item must be empty.
    * The Pick List Item Count must be empty.
    * If the **Material** is associated with a **Resource**, and the state of the **Material** is Consumable, Durable, Dispatched, In Process, or the property In Store is set to `true`, the **Resource** Inventory Locked must be `false`.
* The Parent **Material** and **Sub-Material** Package Count must be empty.
* The **Sub-Material** to be detached has a Parent **Material**.
* The **Flow** of the **Material** being detached is Enabled.
* If the property Use Container Restrictions in the **Step** of the **Material** is `true`, the available containers will be the ones that match the restrictions applied by the context of that **Step**. For more information, see [[step-page#contexts-view|Contexts View]] or [[materialcontainertypecontext-st]].

    !!! note
        The Container Used Positions must be less than the Container Max Usable Positions.

## Preconditions for Bulk

* In addition to the preconditions mentioned above, all Sub-Materials must:
    * Be detached from the same Parent **Material**.

## Sequence of Steps

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

### Step 1: Sub-Materials

1. Select the **Material** you need.
2. Select **Detach**.
3. In the Detach Material wizard, select the **Sub-Materials** to detach by selecting the respective checkbox(es).

![Screenshot showing a wizard with checkboxes for selecting sub-materials to detach.](images/detach_material2.png)

### Step 2: Containers

1. Optionally, expand the **Options** section.
2. If the main **Material** has future holds associated to it, define if the **Sub-Material** will Copy Future Holds.
3. Define if the **Sub-Material** will Terminate Material on Zero Quantity(ies) and no **Sub-Materials**.
4. Define if the **Sub-Material** will Copy Characteristics.
5. Select the container, if one exists, for the **Sub-Material**.
6. Select **Detach** to complete the operation.

![Screenshot showing a UI with a button labeled "Detach" in the context of detaching a container.](images/detach_material3.png)

!!! info
    It is possible to define a default value for the Copy Future Holds, Terminate Material on Zero Quantity(ies) and No Sub-Materials, and Copy Characteristics options by adding the entries Context = `Material.Detach` and Element = `CopyFutureHolds`, Context = `Material.Detach` and Element = `TerminateOnZeroQuantity`, Context = `Material.Detach` and Element = `CopyCharacteristics` in the [[guielementdefaultvalue-gt]] Generic Table.