---
alias: create-material-subproduct
description: "This documentation outlines creating multiple products associated with a material’s sub-product tree"
---

# Create Material Sub-Product

:lock: Material.**CreateSubProduct**

## Overview

This operation is used to define multiple **Products** for a **Material**. This is achieved by expanding the **Material** and changing the expanded **Material** Product.

## Setup

No special setup is required other than to meet the preconditions of the transaction. Note that the new possible *SubProducts* are defined in the **Product** Sub-Product tree of the **Material** Product.

## Preconditions

* The **Material** is Active.
* The **Material** is not OnHold, not InTransit and it is not Consumable.
* The **Material** CurrentBOMVersion must not be defined.
* The Primary Quantity of the new expanded **Material** is greater or equal to zero and less or equal to the **Material** Primary Quantity. Its Secondary Quantity (if defined) is greater or equal to zero and less or equal to the **Material** Secondary Quantity.
* The new **Product** and **Flow** exist, are Active and are enabled.
* The new **Material** SubProduct must be defined in the **Product's** SubProducts tree of the **Material** Product.
* If the **Material** has a **Production Order** associated with it, the **Material** IsProductionComplete property must be false.

## Sequence of Steps

This screen captures all the necessary information for the transaction.

1. Select Create Sub-Products, accessible through the vertical dots button
  
    ![Screenshot showing a UI with a "Create Sub-Products" option.](images/create_sub_products_option.png)

2. Verify the **Material** information.
3. Specify the Sub-Products to be created for the **Material**, using the :material-plus: and :material-trash-can: buttons, specifying for each Sub-Products:
    * the Sub-Product's name - can be left unchanged if there is a name generator that will generate the name.
    * the Sub-Product's primary and secondary quantities - note that the quantities of the **Main Material** are updated accordingly.
    * the Sub-Product's product - from a list of possible **Product** Sub-Products.
4. Optionally, enter a comment.
5. Select **Create** to complete the operation.

![Screenshot showing a UI element labeled "Create Sub-Products".](images/create_material_subproduct.png)