# Properties

The Properties section is the central place for defining and managing material properties. Each property can be assigned to a [property group](/total-materia-integrator/creator/data-maintenance/property-groups.md) and a [unit group](/total-materia-integrator/creator/data-maintenance/units.md), and configured with a specific type (number, text, dropdown list, link) along with its related items. Additionally, property value formatting is handled within this section.&#x20;

Along with [Property Groups](/total-materia-integrator/creator/data-maintenance/property-groups.md) and [Units](/total-materia-integrator/creator/data-maintenance/units.md) sections, it forms a complete framework for fully defining material properties, including their [desired values](/total-materia-integrator/creator/materials-management/add-edit-material-data-properties-diagrams-and-documents.md) as specified in [Materials](/total-materia-integrator/creator/materials-management/add-edit-material-data-properties-diagrams-and-documents.md) section.

To create a new property or edit/delete an existing one, simply click the "ADD PROPERTY" <img src="/files/53f8aPyL36lp6hpwvqUe" alt="" data-size="line"> or <img src="/files/gZVQvKOaachot6qs8lPO" alt="" data-size="line"> buttons in the interface.

To search for existing properties, enter the full or partial property name in the <img src="/files/mZJ1W4BTk01FcySC91iT" alt="" data-size="line">  text box and/or choose the relevant property group from <img src="/files/FvtMk1U67U3jEeQT26yO" alt="" data-size="line"> drop-down list.

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

### Add/Edit a Property

Clicking the "ADD PROPERTY" <img src="/files/Mt3IeSPospCYea7qw1Ai" alt="" data-size="line"> button opens a new window where users must first define the property group by selecting it from the [Property Group](/total-materia-integrator/creator/data-maintenance/property-groups.md) drop-down list.&#x20;

"Property" text box, in which the property name is defined, is mandatory and must be populated.&#x20;

<figure><img src="/files/Bb0FDAD1VKLanzYaqSam" alt=""><figcaption><p><strong>Figure 2:</strong> Screenshot of defined Property Group and Property fields</p></figcaption></figure>

Property type is mandatory and it is selected from "Property Type" drop-down list (by default property type is set as "Number"). Property can be set as one of five different types: "Date" - Property as generic date picker field, "Dropdown" - Property as dropdown list with defined items, "Link" - Property as web link field,  "Number" - Property as generic number filed and comment or as "Text" - Property as generic text input field.

<figure><img src="/files/4qF2Hom9VdrOEWzMZxkm" alt=""><figcaption><p><strong>Figure 3:</strong> Screenshot of Property Type drop-down list</p></figcaption></figure>

Optionally, property values can be color-coded by selecting the preferred color from the color picker palette.

To select property units, choose the desired unit group from the [Unit groups](/total-materia-integrator/creator/data-maintenance/units.md) drop-down list. Use the unit group search text box to more easily find the desired unit group(s). If needed, multiple unit groups can be selected for one property.&#x20;

If a temperature field should be defined for the property, check the <img src="/files/YxJmGxqep0zG77GvAGmr" alt="" data-size="line"> checkbox.

If a standard deviation field should be defined for the property, check the <img src="/files/5SW3IDmbyzQGKx2UX4Fg" alt="" data-size="line"> checkbox.

If a link field should be defined for the property, check the <img src="/files/LravR8hJr5Uapejakq7y" alt="" data-size="line"> checkbox.

Click the <img src="/files/2yt74CKd9jLNRdFhrdC5" alt="" data-size="line"> button for saving new properties and <img src="/files/f1GgLAovl1QYlCsIw5rY" alt="" data-size="line"> button for saving edited properties.

<figure><img src="/files/cgkcrtbsFEHMgxHCe7f0" alt=""><figcaption><p><strong>Figure 4:</strong> Screenshot of Add property window with with populated fields</p></figcaption></figure>

### Add/Edit Property Item

To add or edit a new property item (applicable only for properties in the form of drop-down) click <img src="/files/i4HAwckWp1qHf8ORv04N" alt="" data-size="line"> link. A new window will open, where new property items entries can be created by clicking<img src="/files/aHDCmyHi2PyGyhivFDL0" alt="" data-size="line"> button or edited/deleted using <img src="/files/KCa41rASGhodEEGOUlKw" alt="" data-size="line"> buttons.

To search for an existing property items enter the full or partial property item name in the <img src="/files/uZtfr4IstIMVCptAydhJ" alt="" data-size="line"> text box.&#x20;

To return to the "Properties" page, click the <img src="/files/NEfFXeIKitE56BuYcB5O" alt="" data-size="line"> button, located in the upper left corner of the "Property Item" page.

<figure><img src="/files/4vXdpNjNEf14Ez9p7OmD" alt=""><figcaption><p><strong>Figure 5:</strong> Screenshot of Property Item in Properties section</p></figcaption></figure>

### Format Display of Property Values

To format properties in the form of number use the <img src="/files/VoOuHSFNzNS0kPQtIKN3" alt="" data-size="line"> link to the right of each property. This will open a "Format Number" window where the formatting of property values is defined.

Number formatting can be applied both for metric and imperial units separately (click the slider to the right for imperial unit setting). Four format types can be applied, as follows:

* "None": Property values are displayed as inserted - no formatting is applied.
* "STD(d)": Property values are formatted with defined number of decimals (including 0 decimals) inserted in "Number of decimals" box. Use trailing zeros option can be applied by checking "Use trailing zeros" checkbox.
* "EXP(s)": Property values are formatted with defined number of significant digits inserted in 'Number of significant digits' box and displayed in E-labeled scientific notation.
* "EXP3(s)": Property values are formatted using a defined number of significant digits inserted in "Number of significant digits" and displayed in E-labeled scientific notation, with the significand as a three-digit integer.

{% hint style="warning" %}
If multiple unit groups are defined for one property, make sure to select the desired one for formatting from "Unit Group" drop-down list.

Each metric and imperial unit requires individual formatting set-up.
{% endhint %}

<figure><img src="/files/430ByUEFjO6vh8OXrhZx" alt=""><figcaption><p><strong>Figure 6:</strong> Screenshot of Format number window when selecting STD(d) as formatting type</p></figcaption></figure>


---

# 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/properties.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.
