# Materials

The **Materials** tab in Settings allows you to configure two key elements used across the Materials catalogue:

1. **Material currency** - the currency applied to all material prices.
2. **Parameter templates** - the list of attributes and their possible values that users can apply to materials.

### **1. Material Currency**

Defines the currency used across Materials catalogue and their prices. By default, the value is set to USD currency.

#### **How to change the currency**

1. Open **Settings → Materials**.
2. Click the currency field or start typing the currency name.
3. Select a currency from the drop-down list.
4. The change applies immediately to:
   * all existing materials prices
   * default currency in the “New material” modal

{% hint style="info" %}
ℹ️ **When the currency is changed, the system does not recalculate values**.\
\&#xNAN;*For example, 10 UAH becomes 10 USD, not converted.*
{% endhint %}

{% @arcade/embed flowId="VbpPeBXpERxrds8AejKJ" url="<https://app.arcade.software/share/VbpPeBXpERxrds8AejKJ>" %}

### **2.** Parameter Templates

Parameter templates define which attributes can be assigned to materials. You can add, rename, delete, search, and reorder both parameters and values.

To open the editor:

1. Go to **Settings → Materials**.
2. Click **Manage templates**.
3. You can see the **Manage templates modal** with:
   * Parameter list on the left
   * Values list for the selected parameter on the right

<figure><img src="/files/r6nOq1xQ9sbDpOybc0Y6" alt=""><figcaption></figcaption></figure>

### **Adding Parameters**

#### **Adding first parameter (empty list)**

If the system has no parameters:

1. Click **Add templates**.
2. Enter the parameter name.
3. Click ✅.
4. The parameter appears in selected state.
5. An empty “Values” area appears on the right - you must add at least one value before Apply becomes active

<figure><img src="/files/NoMyPNiE51fDS62jdnja" alt=""><figcaption></figcaption></figure>

#### **Adding additional parameters**

1. Click **Add parameter**.
2. Type the name → Click **✅**.
3. The parameter is added to the list.
4. Its Values section becomes active for editing.

{% @arcade/embed flowId="SOULJEgmNVHxEdxqW1FW" url="<https://app.arcade.software/share/SOULJEgmNVHxEdxqW1FW>" %}

### **Adding Values**

#### **Adding first value**

1. Select a parameter.
2. Enter the value name in the Value input.
3. Click  **✅**.
4. System adds the value to the bottom of the list.

{% @arcade/embed flowId="W9BH2bkgSSrigTZZxYwP" url="<https://app.arcade.software/share/W9BH2bkgSSrigTZZxYwP>" %}

#### **Adding additional values**

1. Select a parameter.
2. Click **Add value**.
3. Enter the value name in the Value input.
4. Click  **✅**.
5. Click **Apply** at the bottom of the modal to save changes.

{% @arcade/embed flowId="22vC6xSkOeVYyhZ3MqA6" url="<https://app.arcade.software/share/22vC6xSkOeVYyhZ3MqA6>" %}

### **Searching**

#### **Search parameters**

1. Type in the **Search by parameter** field.
2. The list shows only matching parameters.
3. If nothing matches → **“No results”** appears.

#### **Search values**

1. Type in **Search by value**.
2. Matching values are displayed.
3. If nothing matches → **“No results”** appears.

{% @arcade/embed flowId="8lxVVaXNnAkZPv0fJy9S" url="<https://app.arcade.software/share/8lxVVaXNnAkZPv0fJy9S>" %}

### **Editing**

#### **Editing parameter name**

1. Click the parameter name.
2. Edit the text.
3. Click ✅.
4. The new name is saved locally and becomes active after clicking **Apply**.

#### **Editing value**

1. Click the value name.
2. Edit the text.
3. Click ✅.
4. Value updates locally and becomes active after clicking **Apply**.

{% @arcade/embed flowId="qMjiqrj9bWwUyTDsDrjH" url="<https://app.arcade.software/share/qMjiqrj9bWwUyTDsDrjH>" %}

### **Deleting**

#### **Deleting a parameter or value**

1. Click on the parameter/value name.
2. Click 🗑️ to delete an attribute.
3. If parameter/value **is used in materials:**
   1. System **deactivates** it
   2. Hidden from drop downs in new materials
   3. Still shown in materials where used

{% hint style="danger" %}
If you try to delete the last parameter or value, system disables button "**Apply**".
{% endhint %}

{% @arcade/embed flowId="a1tILaDwDzK91Wmz7w39" url="<https://app.arcade.software/share/a1tILaDwDzK91Wmz7w39>" %}

### **Reordering values**

1. Grab a value using the drag handle.
2. Drag it to a new position.
3. System saves the updated order immediately locally.
4. Order is fully saved after clicking **Apply**.

{% @arcade/embed flowId="JkMqbdtnjIljffxwUgZX" url="<https://app.arcade.software/share/JkMqbdtnjIljffxwUgZX>" %}


---

# 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://docs.hesh.app/manuals/settings/materials.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.