---
alias: user-guide-add-material-to-container
description: "Associate material with a container, ensuring prerequisites are met for successful operation"
---

# Add Material to Container

:lock: Material.**AddToContainer**

## Overview

This operation is used to associate a **Material** with a **Container** at a given **Container** position.

## Setup

* A **Container** must be available with unused positions at the capacity unit of the **Container**, which matches the primary or secondary quantity of the **Material**.

## Preconditions

* **Container** is Active and there are free available positions in the **Container**.
* **Material** and **Container** are in the same **Facility**.
* **Material** is not In Transit.
* The **Container** is in state Available.
* **Material** does not currently have a **Container** associated with it. Refer to [Transfer Material Between Containers](../container/transfer_material_between_containers.md) if that is the case.
* If the **Container** has the property Is Auto Generate Position Enabled set to `False`, the supplied Position must not already be in use at the **Container**.
* 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 [Contexts View](../../../business-data/step/step_page/#contexts-view) or [MaterialContainerTypeContext](../../administration/tables/smart-tables/materialcontainertypecontext.md).

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

* If the Capacity Validation Mode of the **Container** is Units, the Capacity Units must be the same as either the Primary Units or the Secondary Units of the **Material** and the quantity of the **Material** being associated cannot exceed the Capacity Per Position. If the Capacity Validation Mode of the **Container** is Form, the **Material** must have the same Form as the one defined in the Capacity Form of the **Container**.
* If the Top Most **Material** is associated with a **Resource** of Position Unit Type that is Container, the following must be observed:
    * The Resource Association Type of the **Container** must be None or Related Material.
    * If the **Container** is already associated with a **Resource** (Resource Association Type is Related Material), the **Container** must be associated with the **Resource** where the Top Most **Material** is currently associated.
    * If the **Container** is not already in the **Resource** (Resource Association Type is None), and if the Container Type matches the Position Container Type of the **Resource** or the Position Container Type of the **Resource** is `Null`, the **Resource** must have at least one available position, and it must have the Is Auto Generate Position Enabled set to `True`.

## Sequence of Steps

### Step 1

1. Verify the **Material** information and select the **Container** that will be associated with the **Material**.  
2. If the **Container** does not have the property Is Auto Generate Position Enabled set to `True`, you must supply a valid unused **Container** position for the **Material**.
3. Optionally, enter a Comment.
4. Select **Add** to complete the operation.

![add_material_to_container][add_material_to_container]

[add_material_to_container]: images/add_material_to_container.png