---
alias: user-guide-add-container-container
description: "This documentation details adding a sub-container within a main container structure"
---

# Add Container to Container

:lock: Container.**AddContainer**

## Overview

This operation is used to add a **Container** to a position within a **Container**. As a naming convention, the **Container** that contains the **Container** is called Main **Container** and the **Container** to be contained is called **Sub-Container**.

## Setup

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

## Preconditions

* The main **Container** is Active, Available and Not On Hold.
* The main **Container** position unit type is **Containers** and it has free available positions.
* If the main **Container** property **Allow Mixed Types** property is set to `false`, the SubContainer type must match the type of the existing **Containers** in the **Container** (if any).
* The SubContainer is Active, Available and Not On Hold.
* The main **Container** and the SubContainer are in the same **Facility**.
* The SubContainer is not contained in another **Container**.
* The relationship between the Main Container Type and the Sub-Container Type must be defined in the generic table `ContainerTypeRelation`.
* As a result of this transaction, a circular **Container** relationship cannot exist.

## Preconditions for Bulk

* In addition to the preconditions mentioned above, all **Containers** must:

    * Be associated with the same **Container**.

## Sequence of Steps

### Step 1: Details

1. Specify the **Container** that will contain the **Container**.
2. If the positions are managed manually, it is necessary to specify a free position to hold the **Container**. If they are Auto-Generated, the field will be filled in automatically.  
3. Optionally, enter a comment.
4. Select **Add** to commit the changes.

![Screenshot showing a UI with an "Add Container" option selected, as part of the step to add a new container.](images/add_container.png)