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

# Locations

> Organize your inventory with hierarchical storage locations

## Overview

Locations help you track where items are physically stored. You can create a hierarchical structure (buildings → floors → rooms → shelves) that mirrors your actual storage setup.

## Understanding Location Hierarchies

Invenicum uses a tree structure for locations:

```
Warehouse A
├── Floor 1
│   ├── Room 101
│   └── Room 102
└── Floor 2
    ├── Room 201
    └── Room 202
```

Each location can have:

* **Parent location**: The location it belongs to
* **Child locations**: Locations inside it

<Tip>
  Build your location tree to match how you physically organize items. This makes inventory checks and item retrieval much faster.
</Tip>

## Viewing Locations

The **Location Scheme** screen shows your location hierarchy as an interactive graph:

* **Nodes**: Represent individual locations
* **Connections**: Show parent-child relationships
* **Root**: Top-level locations (no parent)

### Graph Controls

* **Zoom In/Out**: Mouse wheel or pinch gesture
* **Pan**: Click and drag the background
* **Center View**: Click the center icon in the toolbar
* **Zoom to Fit**: Click the fit icon to see all locations
* **Refresh**: Reload locations from the server

## Creating Locations

<Steps>
  <Step title="Open Locations Screen">
    From your container, navigate to **Locations** in the sidebar.
  </Step>

  <Step title="Click Add Location">
    Click the **Add Location** button (📍 icon) in the top toolbar.
  </Step>

  <Step title="Enter Location Details">
    Fill in the location form:

    * **Name** (required): Location identifier (e.g., "Room 101", "Shelf A")
    * **Description**: Additional context or notes
    * **Parent Location**: Select a parent to nest this location (optional)
  </Step>

  <Step title="Save the Location">
    Click **Save** to create the location.
  </Step>
</Steps>

### Creating Root Locations

For top-level locations (buildings, warehouses, offices):

* Leave **Parent Location** empty or select "None"
* These appear as root nodes in the location graph

### Creating Nested Locations

For locations inside other locations:

* Select the parent from the **Parent Location** dropdown
* The new location will appear as a child in the hierarchy

<Note>
  You can nest locations as deeply as you need, but 3-4 levels is usually sufficient (e.g., Building → Floor → Room → Shelf).
</Note>

## Editing Locations

<Steps>
  <Step title="Select the Location">
    In the location graph, click on the location node you want to edit.
  </Step>

  <Step title="Click Edit in Action Panel">
    A panel appears at the bottom showing the selected location. Click the **Edit** button.
  </Step>

  <Step title="Modify Details">
    Update the name, description, or parent location.
  </Step>

  <Step title="Save Changes">
    Click **Save** to apply the updates.
  </Step>
</Steps>

### Changing Parent Locations

You can move locations within the hierarchy by changing their parent:

1. Edit the location
2. Select a different parent from the dropdown
3. Save the change

The location (and all its children) will move to the new parent.

<Tip>
  **Reorganizing Made Easy**: If you need to restructure your locations, edit parent relationships rather than deleting and recreating locations. This preserves item assignments.
</Tip>

## Deleting Locations

<Steps>
  <Step title="Select the Location">
    Click the location node in the graph.
  </Step>

  <Step title="Click Delete">
    In the action panel at the bottom, click the **Delete** button.
  </Step>

  <Step title="Confirm Deletion">
    Confirm that you want to delete the location.
  </Step>
</Steps>

<Note>
  **Warning**: You cannot delete locations that:

  * Have items assigned to them
  * Have child locations

  First move items to another location and delete/move child locations, then you can delete the parent.
</Note>

## Assigning Items to Locations

Locations are assigned when creating or editing items:

### During Item Creation

1. In the **Main Data** section of the item form
2. Select a location from the **Location** dropdown
3. All available locations in the container are listed

### Editing Item Location

1. Open the item details
2. Click **Edit**
3. Change the **Location** dropdown to a new location
4. Save the changes

<Tip>
  The location dropdown shows the full path for nested locations (e.g., "Warehouse A → Floor 1 → Room 101") to avoid confusion.
</Tip>

## Viewing Location Contents

To see what's stored in a location:

### From the Item List

1. Open an asset type's item list
2. Use the **Location Filter** to show only items in a specific location
3. The list updates to show items at that location

### From Reports

Generate an inventory report filtered by location to get a comprehensive list of items. See [Reports](/guides/reports) for details.

## Moving Items Between Locations

To relocate items:

<Steps>
  <Step title="Edit Single Items">
    For one item at a time:

    1. Open the item
    2. Click Edit
    3. Change the Location
    4. Save
  </Step>

  <Step title="Bulk Moves (Advanced)">
    For multiple items:

    1. Use the API or CSV export/import workflow
    2. Update locations in bulk
    3. Re-import with new locations
  </Step>
</Steps>

<Note>
  There's currently no built-in bulk location editor in the UI. For moving many items, consider using the API or CSV export/edit/import workflow.
</Note>

## Location Best Practices

<Tip>
  **Match Physical Reality**: Structure your locations exactly as your physical space is organized. This makes finding items intuitive.
</Tip>

<Tip>
  **Use Descriptive Names**: "Room 101" is better than "R1". "Shelf A" is better than "1". Clear names reduce confusion.
</Tip>

<Tip>
  **Start Broad, Then Narrow**: Create big locations first (buildings, warehouses), then add detail (rooms, shelves) as needed.
</Tip>

<Tip>
  **Limit Nesting Depth**: 3-4 levels is usually enough. Too many levels make location selection tedious.
</Tip>

<Tip>
  **Add Descriptions**: Use the description field for things like "Next to loading dock" or "Temperature controlled storage".
</Tip>

<Tip>
  **Plan for Growth**: If you might expand to more buildings or rooms, name locations with room for growth (Building A, B, C rather than "The Building").
</Tip>

## Common Location Patterns

### Office Setup

```
Office
├── 1st Floor
│   ├── Reception
│   ├── Conference Room A
│   └── IT Room
└── 2nd Floor
    ├── Storage Room
    ├── Server Room
    └── Break Room
```

### Warehouse Setup

```
Warehouse
├── Receiving
├── Zone A
│   ├── Aisle 1
│   └── Aisle 2
├── Zone B
│   ├── Aisle 1
│   └── Aisle 2
└── Shipping
```

### Retail Setup

```
Store
├── Sales Floor
│   ├── Electronics
│   ├── Clothing
│   └── Grocery
└── Back of House
    ├── Stockroom
    └── Office
```

## Common Questions

### Can items be in multiple locations at once?

No, each item has one assigned location. If you have items spread across multiple locations, create separate item entries for each physical piece.

### What if I don't know where an item is?

Create a special "Unknown" or "Missing" location for items whose location is uncertain. This lets you track that the item exists but needs to be located.

### How do I handle items in transit?

Create locations like "In Transit", "Loaned Out", or "Maintenance" for items that aren't in their normal storage location.

### Can I rename locations?

Yes, edit the location and change its name. Items assigned to that location will automatically reflect the new name.

### How do I see which items are in a location?

Use the location filter in the asset list, or generate an inventory report filtered by location.

### Can I delete a location if it has items?

No. First reassign all items to a different location, then you can delete the empty location.

## Related Topics

* [Managing Items](/guides/managing-items) - Assign items to locations
* [Reports](/guides/reports) - Generate location-based inventory reports