> For the complete documentation index, see [llms.txt](https://cowsinss-organization.gitbook.io/inventory-pro-add-on-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cowsinss-organization.gitbook.io/inventory-pro-add-on-documentation/how-to-use-and-guides/inventory-designer-creating-updating-and-deleting-inventory-grid-data.md).

# Inventory Designer: Creating, Updating & Deleting Inventory Grid Data

Inventory Grid Data contains information regarding the initial storage configuration of the player's inventory and any chests. You can create as many Inventory Grid Data entries as needed. While only one can be assigned to the player’s inventory, you can create multiple Inventory Grid Data entries and assign them to different chests, allowing each chest to contain its own unique initial data.

***

## Introduction

To manage Inventory Grid Datas, begin by opening the Cowsins Manager. First, press the Ctrl+Q shortcut, then click on "Inventory Designer." The following window will appear:

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FZp5y4UhpulcBogtMuTZH%2Fimage.png?alt=media&amp;token=f81be93a-ec5d-4016-ad58-fc4599b62109" alt=""><figcaption></figcaption></figure>

Here, you will find a list of the available InventoryGridData\_SOs within your project. By clicking on each button, you can access the Inventory Designer for that specific InventoryGridData\_SO, allowing you to customize its preferences, settings, items, and layout.

Additionally, from this home page, you can create new Inventory Grid Data entries.

## Creating Inventories Data

From the Home Page of the Inventory Designer in Cowsins Manager, click on "Create New Inventory Grid Data", then you´ll need to select a path to store the File.&#x20;

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FaOaPH7h46saoW72G8U7M%2Fimage.png?alt=media&amp;token=13c241f8-90ac-4b43-b396-1a94bf055a73" alt=""><figcaption></figcaption></figure>

1. Click on "CREATE NEW INVENTORY GRID DATA"
2. Select a proper path within your project to keep files organized.
3. Give the new File a name.
4. Save the File

{% hint style="info" %}
It is highly recommended to store all InventoryGridData\_SOs within the same folder.
{% endhint %}

Now, you can start configuring and adjusting the preferences of your Inventory Grid Data\_SO. For more information, refer to [Updating Inventories Data](#updating-inventories-data).

## Updating Inventories Data

From the Home Page of the Inventory Designer in Cowsins Manager, click on the InventoryGridData\_SO you want to modify from the list. In this case, we´ll modify *SampleChest\_01*.

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FK0r56tRfyfDHcm9irI7g%2Fimage.png?alt=media&amp;token=b9416655-6458-4433-814a-c3dbdece4472" alt=""><figcaption></figcaption></figure>

This will open the **Inventory Designer Tool**, where you can modify and customize `SampleChest_01`. The Inventory Designer is divided into two main sections:

* **Left Section**: Displays the inventory grid.
* **Right Section**: Contains the toolset, organized into four tabs:

1. ***SELECTION MODE:*** Allows you to select an item from the grid on the left to view its details such as name, icon, attachments (if it's a weapon), and edit the available amount.\
   If you enter an amount higher than the item’s Max Stack value, it will automatically be clamped to that maximum. The minimum amount allowed is 1.
2. ***DESIGN MODE:*** Displays a list of all `Item_SO` assets in your project. You can search for the item you need, click on it, and place it on the grid in the left section.\
   Items are placed based on the `itemSize` defined in their `Item_SO`. If you're not using a Tetris-style inventory, all items will be treated as 1x1 during runtime.\
   To remove an item, simply right-click it on the Left Section.
3. ***SETTINGS TAB:*** Here you can configure the inventory grid’s layout, adjust slot spacing, padding, and the number of rows and columns.
4. ***HELP TAB:*** Provides access to useful resources, including documentation, tutorials, and a list of keybinds.

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2Fym3gH9R0Qecyqpezz063%2Fimage.png?alt=media&amp;token=658e1e41-7458-4bbf-afb2-a34f77416f24" alt=""><figcaption></figcaption></figure>

### ADDING ITEMS TO THE GRID

Let´s add, edit and remove an Item as an example. In this case, we´ll add a Katana, which is a 3x1 Item.

First, search "Katana" in the SearchBar, the Katana item will be filtered.

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FopO4YQ3v63K2nCWOzReP%2Fimage.png?alt=media&amp;token=b8464a8d-afa4-4d5a-9655-35040f04f31d" alt=""><figcaption></figcaption></figure>

Now, click on the Katana Item. As you can see, it is now displayed as selected.

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FNapsDAqgJQuuWTVRgiRs%2Fimage.png?alt=media&amp;token=291a72bd-d8e1-4290-a326-7b72dd60ea7a" alt=""><figcaption></figcaption></figure>

Now, to place the item onto our grid, keep in mind that it's a **3x1 item**. Items are always placed starting from the **top-left slot** of their occupied area ( Anchor ). This means you’ll need to make sure the item fits within the grid boundaries and doesn’t overlap with any existing items. If it would go out of bounds or collide with something else, placement won’t be allowed.<br>

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2F1l5ayn1JMJeN5cx0x0GV%2Fimage.png?alt=media&amp;token=7939b264-201f-400e-982b-1e02f42a5b47" alt=""><figcaption></figcaption></figure>

Click on the Slot to place the Item. As you can see, it fits perfectly.

{% hint style="info" %}
**Note:** Always be mindful of your item's size. Items are anchored and placed starting from the **top-left position**, so make sure there's enough space on the grid to fit the entire item without overlap.
{% endhint %}

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FmTN5AgeLjEuoeVqcWbm4%2Fimage.png?alt=media&amp;token=be1f3cf7-1306-4478-ad7e-8203b102da30" alt=""><figcaption></figcaption></figure>

### EDITING AN ITEM FROM THE GRID

While in **Selection Mode**, click on any slot that contains part of the item. In the case of the **Katana**, which takes **3x1 slots**, any of those three slots can be selected to view and edit its details.

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FjVQ7bLrrpM6b8XbsONBY%2Fimage.png?alt=media&amp;token=61df455e-53ea-4c9b-93f7-cb7d70a1c94a" alt=""><figcaption></figcaption></figure>

Here, you can view detailed information about the selected item and adjust its amount. In this case, since the item is a **weapon** (like the Katana), only **one** can be carried in those slots. For other items such as an **apple,** you can modify the amount anywhere from **1 up to the Max Stack** defined in its `Item_SO` file.

## Deleting Inventories Data

To Delete an Item from the Grid, simply right-click on it.

## Inventory Data Considerations

### UPDATING ITEM\_SO SIZES ( ONLY FOR TETRIS INVENTORIES )

When working with **Items** and **InventoryGridData**, there may be times when you need to adjust an item's settings after it's already been placed in the grid, such as changing its size.\
Reducing the item size usually doesn't cause issues, but **increasing the size** can lead to problems. The item may end up **overlapping with others** or even **extending outside the grid boundaries**.

Below is an example of what might happen if you change the **Katana's size from 3x1 to 4x1** after it has already been placed in the grid.

<figure><img src="https://82980203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXr4tnFxEQlPvYDitAgDT%2Fuploads%2FVHtxIyJNSQgQ3fl7xXSg%2Fimage.png?alt=media&amp;token=058b350a-8e6c-406c-b121-604fa5bfbc3b" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">Original 3x1</mark> Size VS <mark style="color:red;">Updated 4x1</mark> Size.

#### What to do now?

Delete the overlapping Items and re-adjust your Grid Layouts or Item Sizes to ensure all Items fit properly.
