# Units

The Units section serves as a unit management section for storing, sorting, and organizing units and unit groups efficiently. It enables users to consistently create desired unit groups and associate multiple units with them. Configure multiple metric and imperial units, set default preferences for both, assign conversion factors, and convert [property](/total-materia-integrator/creator/data-maintenance/properties.md) values between metric and imperial unit systems.

To create a new unit group or edit/delete an existing one, simply click the "ADD UNIT GROUP" <img src="/files/DPL97DbiWtVtnxzuBCd7" alt="" data-size="line"> or <img src="/files/gZVQvKOaachot6qs8lPO" alt="" data-size="line"> buttons in the interface.

To search for existing unit group, enter the full or partial unit group name in the <img src="/files/ozW8UJ0pk93d0CeGipD4" alt="" data-size="line"> text box and/or enter the full or partial unit name in the<img src="/files/zSm84jiC8WHkvW8W3NMp" alt="" data-size="line"> text box.

<figure><img src="/files/PneuXnYyEEmecPwSn0gX" alt=""><figcaption><p><strong>Figure 1:</strong> Screenshot of Units in Data Maintenance section</p></figcaption></figure>

Clicking the "ADD UNIT GROUP" button opens a new window where the user defines the desired unit group name (optionally including a unit in brackets for clarity). The desired unit group is saved by clicking the "ADD" button.

<figure><img src="/files/Nwoi0zDuu2OLabPinBTu" alt=""><figcaption><p><strong>Figure 2:</strong> Screenshot of defined Unit Group</p></figcaption></figure>

The next step in setting up the desired unit group is to assign related units by clicking the <img src="/files/i4HAwckWp1qHf8ORv04N" alt="" data-size="line"> link and <img src="/files/tIyY8XwFPYcyGHhSPr8C" alt="" data-size="line"> button or <img src="/files/gZVQvKOaachot6qs8lPO" alt="" data-size="line"> buttons for editing/deleting available units.

Clicking the "ADD UNIT" button opens a new window where the desired units are defined, with each field representing the following:

* "Unit name": Name of the unit (e.g. kg/dm³). Mandatory field.
* "Factor": Conversion factor (by default = 1, if no conversion is needed). E.g. conversion factor = 27.6799 when converting from kg/dm³ to lb/in³. Mandatory field.
* "Offset": Conversion factor for properties where conversion involves mathematical operations such as + or − (e.g. offset = −17.7776 for conversion from °C to °F). Mandatory field.
* "Default Metric": Check box to mark the unit as the default metric unit (e.g. kg/dm³ for Density). Optional field.
* "Default Imperial": Check box to mark the unit as the default imperial unit (e.g. lb/in³ for Density). Optional field.

<figure><img src="/files/vYsB8F5yjVYRjJ7HX8LD" alt=""><figcaption><p><strong>Figure 3:</strong> Screenshot of Edit Unit window with fields populated for °F as a unit</p></figcaption></figure>

<figure><img src="/files/W3liSY8GnVYaDSNX9kxN" alt=""><figcaption><p><strong>Figure 4:</strong> Screenshot of Units page for unit group Temperature - [°C]</p></figcaption></figure>

<figure><img src="/files/ngSlnZE3jHsv79GvMjIR" alt=""><figcaption><p><strong>Figure 5:</strong> Screenshot of Units page for unit group Strength - [MPa]</p></figcaption></figure>

{% hint style="warning" %}
**Multiple units can be assigned for one unit group.**&#x20;

**Only one unit can be set as default metric and default imperial unit.**

Examples:

Unit group: Temperature; Units: °C (Default metric), °F (Default imperial), K and R.&#x20;

Unit group: Strength; Units: MPa (Default metric), N/mm², ksi (default imperial), psi, kN/m², kgf/mm², GPa.

**Conversion factors ('Factor' and/or 'Offset') must be specified for each unit conversion.**
{% endhint %}

{% hint style="info" %}
The most common unit groups, with both metric and imperial units, will already be available and predefined in your Total Materia Integrator system. In most cases, you will not need to define anything manually, as the predefined options are ready to be used and cover the majority of typical scenarios.
{% endhint %}


---

# 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.totalmateria.com/total-materia-integrator/creator/data-maintenance/units.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.
