# Item & supply settings

{% hint style="success" %}
To access these settings, you need an **Enterprise plan**.
{% endhint %}

### How to Build an Item and Supply Hierarchy?

Adding and managing assets in the Asset Manager is based on predefined entities:

* **Items**
* **Supplies (hereafter “Supplies”)**

Both Items and Supplies are organized into:

* Item Categories
* Item Subcategories
* Supply Categories
* Manufacturers
* Suppliers

Before adding Items and Supplies, set up your structure by creating categories and subcategories for Items, as well as categories for Supplies.\
By default, the system includes only **Mining Equipment** (category) and **Miners** (subcategory).

You also need to add **manufacturers** and **suppliers** for all future assets.\
All these actions can be managed in: **Settings > Asset Settings**.

### How to Create a New Item?

Items are one of the core entities used to create an asset. Any data entered when creating or editing an Item is automatically applied to all assets linked to it.

1. Build the hierarchy for Items, add manufacturers and suppliers.
2. Go to **Settings > Asset Settings > Items**.
3. Click **Add Item** to open the creation form.
4. Fill in general fields:
   * Name
   * Unique code
   * Category and subcategory
   * Model, manufacturer, supplier
   * Dimensions
   * (Optional) HS code, submodel, linked Items
5. If needed, add **custom fields**.
   * Choose field type, name, and description
   * Configure validation (uniqueness, required)
   * Custom fields created for a subcategory are inherited by all Items in it
6. Attach up to 20 files (manuals, images, documents) via drag-and-drop or file picker.
7. Files can later be:
   * Downloaded
   * Deleted
   * One image set as avatar for the Item and all related assets

### How to Create a New Supply?

Supplies are another entity used to create assets. Data entered when creating or editing a Supply is automatically applied to all linked assets.

1. Add Supply categories, manufacturers, and suppliers.
2. Go to **Settings > Asset Settings > Supplies**.
3. Click **Add Supply** to open the creation form.
4. Fill in general fields.
   * Unlike Items, Supplies do not have subcategories, models, submodels, or linked entities.
5. Add **custom fields** if needed (fields are tied to Supply categories).
6. Attach files just like with Items.

### How to View All Custom Fields?

To see all fields added in creation or edit forms:

1. Go to **Settings > Asset Settings > Custom Fields**.
2. Review the list of all fields and their details.
3. You can:
   * Add a new field
   * Edit existing ones
   * Delete fields (only if no values were entered for them)

### FAQ

<details>

<summary>Why do I need Items and Supplies?</summary>

Without them, you cannot create assets, which are required to track equipment in your company.

</details>

<details>

<summary>Is there a list of models and submodels?</summary>

Models and submodels are entered manually. Once created, they appear in dropdowns for new Items.

</details>

<details>

<summary>How many custom fields can I add?</summary>

There is no limit.

</details>

<details>

<summary>Can I add an Item or Supply without categories?</summary>

No. All Items and Supplies must belong to categories. If unsure, create a general category and subcategory.

</details>

<details>

<summary>What’s the difference between Item/Supply code and HS code?</summary>

* **Item/Supply code**: Internal identifier for your company
* **HS code**: International classification identif

</details>

***

#### We're always available! <a href="#were-always-available" id="were-always-available"></a>

Chat with us on [Telegram](https://t.me/moondmc_bot).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.moonone.online/asset-manager/item-and-supply-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.