---
alias: user-guide-compose-new-material
description: "This documentation outlines creating new materials and their associated quantities or sub-materials"
---

# Compose New Material

:lock: Material.**ComposeNew**

:lock: Material.**Create**

:lock: Material.**CreateTemplate**

:lock: Material.**CreateFromTemplate**

## Overview

This operation is used to create a **Material**, while also creating its Quantities or Sub-Materials in a single operation. For more information, see [[user-guide-create-material]], [[user-guide-compose-material]], and [[user-guide-compose-submaterials]].

## Setup

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

!!! info
    This transaction is relevant for genealogy.

## Sequence of Steps

To Compose a New **Material**, access the **Compose New** button on the top ribbon and choose the desired mode: From Quantities or From Sub-Materials.

![Screenshot showing the "Compose New" button on the top ribbon.](images/compose_new_material_button.png)

### Mode: Quantities

1. Create a Material. Follow the same steps as described in the [[user-guide-create-material]] operation.

    ![Screenshot showing a UI for creating a new material, with fields for quantities.](images/compose_new_create_material.png)  

2. Choose the **Materials** to compose by selecting the :material-plus: icon. For each **Material**, specify the Primary and, if defined, the Secondary Quantities. It is also possible to remove the **Materials** by selecting the :material-trash-can: icon. To perform the transaction, it is necessary to select at least one Source **Material**.

    !!! note
        The final Primary and Secondary Quantities (if defined) are automatically updated to reflect the Composed Quantities.

3. Optionally, enter a comment.
4. Select **Create** to complete the operation.

![Screenshot showing a UI for creating material from composed quantities, with fields for "Materials To Be Composed" and "FO MAAENAL DES".](images/compose_new_quantities.png)

### Mode: Sub-Materials

1. Create a **Material**. Follow the same steps as described in the [[user-guide-create-material]] operation.

    ![Screenshot showing a user interface for creating a material from composed sub-materials.](images/compose_new_submaterials_create_material.png)  

2. Optionally, select a **BOM** of Compose Map scope.
3. Optionally, select a Target **Container**.

    ![Screenshot showing a UI for selecting sub-materials in a material composition process.](images/compose_new_submaterials_compose.png)

4. Select **Next** to continue.
5. Select the Source Parent **Materials** that will be transferred to the Target **Container**. You may select as many as you wish.

    ![Screenshot showing a list of parent materials that can be selected for transfer.](images/compose_new_submaterials_source_materials.png)

6. Select **Next** to continue.
7. Depending on your selections in steps 2 and 3, follow the steps described in [[user-guide-compose-submaterials#step-3-sub-materials-transfer|Sub-Materials Transfer]].

    ![Screenshot showing a UI for creating sub-materials in Compose mode, with options to select source and target containers.](images/compose_new_create_sub_materials_transfer.png)

8. Select **Create** to complete the operation.