> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Warehouse Layout in Eaglecart WMS

> Build racks, shelves and boxes for a location in Eaglecart's WMS layout builder, name them, nest them and save the layout.

[Help Center](https://help.eaglecart.com/introduction.md)

[Inventory and warehouse](https://help.eaglecart.com/inventory-warehouse.md)

Create a warehouse layout

# Create a warehouse layout

A warehouse layout describes how a location is physically organized. In Eaglecart you build it as a tree of up to three levels, such as a rack, a shelf on the rack and a box on the shelf. Each item gets a name and a barcode you can print and stick on the real shelf.

## Before you start

* Choose the location you're organizing, for example your main warehouse. Each location has its own layout.
* Walk the space and decide on a naming scheme, for example **R1** for rack 1, **A1** for its first shelf and **BOX 1** for the first box. Short, consistent names are easier to read on labels.
* Decide how deep you need to go. Small stores may only need racks and shelves.

## Open the layout for a location

1. In the side menu, go to **Warehouse → Layout**.
2. Choose the location from the selector next to **WMS • Layout** at the top, for example **Abu Dhabi**.
3. The **Layout** table lists the top-level items (racks) already created for that location, for example **R1**.
4. Click an item to open the layout builder.

## Build the layout

The builder shows the location's name followed by **• Layout**, with a short reminder of how dragging, duplicating and barcode printing work. Each item is a row with:

| Control | What it does |
| - | - |
| Drag handle | Drag the item to reorder it or nest it under another item. See [Move and reorganize layouts](https://help.eaglecart.com/inventory-warehouse/reorganize-warehouse-layout.md). |
| Chevron | Collapse or expand the items inside a parent. |
| Name field | The item's name, for example **R1**, **A1** or **BOX 1**. |
| **+** | Add an item inside this one. Third-level items have no **+**, because they can't hold anything. |
| Trash icon | Delete the item. |
| Duplicate icon | Copy the item, including everything inside it. |
| Barcode icon | Print the barcode label: **Print This Only** or **Print With Children**. |

To add items:

1. Click **Add Level 1** to add a new top-level item, such as a rack. Type its name, for example **R1**.
2. Under the rack, click **Add Level 2 to R1** (or the **+** on the rack row) to add a shelf. Name it, for example **A1**.
3. Under the shelf, click the add button shown inside it to add a box. In the builder this button reads **Add Level 2 to A1**, even though it adds the third level. Name the box, for example **BOX 1**.
4. Repeat for every rack, shelf and box you need. Use the duplicate icon to copy a rack with all its shelves and boxes, then rename the copies.
5. Click **Save** at the top right.

> [!TIP]
>
> Build one rack completely, check the names, then duplicate it for identical racks. It's much faster than adding every shelf and box by hand.

## Print the labels

Click the barcode icon on a row to print its label. **Print This Only** prints the label for that item. **Print With Children** prints it together with the labels of everything inside it, which is handy for labeling a whole rack at once. To choose what the label shows and its size, click **Barcode settings**. See [Warehouse barcode label settings](https://help.eaglecart.com/inventory-warehouse/layout-barcode-labels.md).

## What happens after you save

The racks, shelves and boxes become layouts you can scan and assign products to. They appear in **Inventory By Layout**, **Inventory By Product** and **Assign Product To Layout**, and in layout paths such as **RAK 1 > Shelf 1 > box 2**.

Creating layout items doesn't change any stock quantities.

> [!WARNING]
>
> Before deleting a rack, shelf or box, check whether products are assigned to it in [Inventory By Layout](https://help.eaglecart.com/inventory-warehouse/inventory-by-layout.md). Move them to another layout first, so you don't lose track of where those units are.

## Troubleshooting

**I can't add anything inside a box.** Layouts have a maximum of three levels. The third level has no **+** button.

**My changes disappeared.** Changes in the builder are kept when you click **Save**. Save before leaving the page.

**The layout list is for the wrong warehouse.** Check the location selector at the top of **WMS • Layout**. Each location has its own layout.

## Related guides

* [Racks, shelves and boxes](https://help.eaglecart.com/inventory-warehouse/racks-shelves-and-boxes.md): how the three levels work.
* [Move and reorganize layouts](https://help.eaglecart.com/inventory-warehouse/reorganize-warehouse-layout.md): drag, nest and duplicate.
* [Scan products into a location layout](https://help.eaglecart.com/inventory-warehouse/scan-products.md): place products on your new shelves.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.