# Parameters

Use the Parameters section to configure and organize parameters at either the material, material description, condition or export level. This section also allows users to select different parameter types (text, drop down lists, number, link etc.), define desired parameter items for parameters in the form of drop-down lists, and customize parameter colors.

To create a new parameter or edit/delete an existing one, simply click the "ADD PARAMETER" <img src="/files/Ykosf3hVzQkeg90pGzx9" alt="" data-size="line"> or <img src="/files/gZVQvKOaachot6qs8lPO" alt="" data-size="line"> buttons available in the Parameters page.

To search for existing parameters, use one of the three available options:

* Enter the full or partial parameter name in the <img src="/files/aLqKeKxiB6t5iT93Dlk2" alt="" data-size="line"> text box.
* Search by parameter type by selecting one or more items from <img src="/files/Tgkz0GmZcy09R6jBaRRP" alt="" data-size="line"> multi-selectable drop-down list.
* Search by where the parameter is used (e.g. condition, material description) by selecting one or more items from <img src="/files/YxEvVXkhSohnT6OKqDYQ" alt="" data-size="line"> multi-selectable drop-down list.

Assignment of parameter to specific[ property](/total-materia-integrator/creator/data-maintenance/property-groups.md) and [material groups](/total-materia-integrator/creator/data-maintenance/material-groups.md) is done by clicking the link <img src="/files/B1QxcKd9bn0GqmJjUlr5" alt="" data-size="line"> positioned in the upper right corner of Parameters page.

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

{% stepper %}
{% step %}

### Configuring Parameters

Clicking the "ADD PARAMETER" button opens a new window for creating a new parameter. Users are obligated to define: Parameter name in "Parameter" text box, parameter type in "Parameter type" drop-down list and where parameter is used in "Used in" multi-selectable check boxes. Setting the parameter color is optional and can be configured by clicking color picker from "Font color" palette.

<figure><img src="/files/S11vEbhILAUu5KnnBiU5" alt=""><figcaption><p><strong>Figure 2:</strong> Screenshot of Add Parameter window when adding Form'as parameter</p></figcaption></figure>

The First step in defining a new parameter is to set its name in the 'Parameter' text box. Once the desired parameter name is entered, users should define parameter type (by default parameter type is set as "Text") by selecting the appropriate item from the "Parameter Type" drop-down list: "Date" - Parameter as generic date picker field, "Dropdown" - Parameter as drop-down list with defined items, "Link" - Parameter as web link field, "Number" - Parameter as generic number field and comment, "Text" - Parameter as generic text input field in a single line or as "Text area" - Parameter as generic text input filed in multi-line.

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

To enable multiple selection of parameter items in a parameter type defined as drop-down list, check the <img src="/files/hzw7DVBwahb8qp4klMnj" alt="" data-size="line"> checkbox.

When "Number" is selected as the parameter type, a new drop-down list named [Unit Groups](/total-materia-integrator/creator/data-maintenance/units.md) appears, containing predefined unit items. This allows the users to select a unit group (e.g. Density - \[kg/dm³]) for defined parameter. Selecting a [unit group](/total-materia-integrator/creator/data-maintenance/units.md) is optional and can be left unpopulated.

{% hint style="warning" %}
Before adding new parameters as number parameter types, ensure unit groups are configured in the [Units](/total-materia-integrator/creator/data-maintenance/units.md) section of Data Maintenance.
{% endhint %}

<figure><img src="/files/CllXrM6wpCV0DCjRxB6B" alt=""><figcaption><p><strong>Figure 4:</strong> Screenshot of Add Parameter window when adding Dimension as parameter and Number as parameter type</p></figcaption></figure>

The next step in completing the parameter setup is to define its usage by selecting "Used in" check boxes. The parameter can be applied in the three material sections: "Material" - used for defining material, "Material description" - used for material description page and  "Condition"  - used for property data conditions. These levels can be selected individially or all together.&#x20;

When "Material" is selected as "Used in" type, the optional "Basic Info" check box is available. Selecting it will impact the parameter visiblibility in the materials [Basic Information section](/total-materia-integrator/creator/materials-management/create-materials.md). Optionally, if this parameter is mandatory, make sure to check the "Mandatory" check box.&#x20;

When "Condition" is selected as "Used in" type and parameter type is set as "Dropdown list",  the optional "Exporter" check box is available. Selecting it will impact the parameter visibility with inserted parameter items in the selected [export page](/total-materia-integrator/total-viewer/export-data/one-click-export.md).

<figure><img src="/files/GI5Krjxrzq9PLsjk4U69" alt=""><figcaption><p><strong>Figure 5:</strong> Screenshot of Add Parameter window when adding Standard Number as Material - Basic Info parameter</p></figcaption></figure>

<figure><img src="/files/fHehQ9iPZaV0S7k3oNoo" alt=""><figcaption><p><strong>Figure 6:</strong> Screenshot of Basic information material window with Standard Number as mandatory parameter</p></figcaption></figure>

<figure><img src="/files/aa6toHO3Mj1WEdKkU8Ku" alt=""><figcaption><p><strong>Figure 7:</strong> Screenshot of Add Parameter window when adding Test sample as Condition - Exporter parameter</p></figcaption></figure>

<figure><img src="/files/yZZBXe9xRVFnu6SiECiq" alt=""><figcaption><p><strong>Figure 8:</strong> Screenshot of Export to CAx window with Test sample as filtering parameter</p></figcaption></figure>

#### Configuration of parameters in the form of drop-down list

Configuration of parameters in the form of drop-down lists is done by clicking the link <img src="/files/2UqYRiLohKefULHCSpgm" alt="" data-size="line"> positioned to the right of "Used in" on the Parameters page. This action opens a new page for editing and creating parameter items.

<figure><img src="/files/Va8mICRQN6v5nIMrQuBV" alt=""><figcaption><p><strong>Figure 9:</strong> Screenshot of Parameters page for parameter type Dropdown and View/Edit items link</p></figcaption></figure>

To add a new parameter item, click the <img src="/files/63uCpiTDhuD56LBicS8r" alt="" data-size="line"> button. This action opens a window where the user can define the item's name and color.

To search existing parameter items, enter the full or partial parameter item name in the <img src="/files/rXDzQltCokEMRObsF4hm" alt="" data-size="line"> search box.

To delete or edit an existing parameter item, click the <img src="/files/gZVQvKOaachot6qs8lPO" alt="" data-size="line"> button on the 'Parameter Items' page.

To return to the "Parameters" section, click the <img src="/files/vdXbZrg9QUijQNzkBT3o" alt="" data-size="line"> button located in the upper-left corner of the "Parameter Items" page.

#### Configuration of parameters in the form of number

Configuration of parameters in the form of number is done by clicking the link <img src="/files/lvEIe70VfouwTYNPjnsl" alt="" data-size="line"> positioned to the right of "Used in" on the "Parameters" page. This action opens a new page for formating of parameter.

<figure><img src="/files/CUNVbsSroKIrOORWYMXL" alt=""><figcaption><p><strong>Figure 10:</strong> Screenshot of Parameters page for parameter type Number and Format number link</p></figcaption></figure>

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.
  {% endstep %}

{% step %}

### Setting Parameters' Visibility

Adjusting parameter visibility is crucial for setting its display within certain [property](/total-materia-integrator/creator/data-maintenance/property-groups.md) and [material groups](/total-materia-integrator/creator/data-maintenance/material-groups.md). Each parameter can be assigned to a specific property group (e.g. mechanical properties, chemical composition) and a material group (e.g., metals, polymers).

To assign a parameter to specific property and material groups, click the link <img src="/files/B1QxcKd9bn0GqmJjUlr5" alt="" data-size="line"> in the top right corner of the "Parameters" page. This opens the "Setup Parameter Visibility" page. This page includes two search options: a multi-selectable drop-down list <img src="/files/7EI6UXksHpv2dEtR6S8i" alt="" data-size="line"> for narrowing the search of property groups and a search field<img src="/files/S6S0hLHTQ7fXyVOhCNh3" alt="" data-size="line"> for filtering already assigned parameters within specific property groups.&#x20;

<figure><img src="/files/oOVtAwfkuPhCOi64LK9e" alt=""><figcaption><p><strong>Figure 11:</strong> Screenshot of Setup Parameter Visibility page</p></figcaption></figure>

After determining the desired property group to which parameter should be assigned, click the <img src="/files/gKrEjmPa3ixAyA7x0dQP" alt="" data-size="line"> link. A new pop-up window named "Assign Parameters" will open, where the desired parameters for selected property groups should be checked.

<figure><img src="/files/RBKkcf1gaKrqD0XY58DQ" alt=""><figcaption><p><strong>Figure 12:</strong> Screenshot of Assign Parameters page</p></figcaption></figure>

The final step in completing the parameter visibility setup is to assign the desired material groups by clicking the <img src="/files/7WXyYM2b4FfcJUVfYZ9H" alt="" data-size="line"> link. A new pop-up window titled "Assign Material Groups" will open. You can assign parameters to specific material groups by clicking the check box to the left of each parameter name corresponding to the desired material group. Additional options for setting parameter visibility for each material group are available, including:

* "Show parameter name in condition": When "ON" enables display of parameter name in condition.
* "Show parameter in condition filter": When "ON" enables display of parameter in condition filters (available only for parameters in the form of drop-down list).
* "Mandatory": When "ON" parameter is set as mandatory.
* Up/down arrows: Set up the parameter order by clicking the arrows up or down for each parameter.

<figure><img src="/files/zMAKxYNKxrCFxD6rtfGr" alt=""><figcaption><p><strong>Figure 13:</strong> Screenshot of Assign Parameters page</p></figcaption></figure>

<figure><img src="/files/q6JJMUO7ay1bJNJl7pgY" alt=""><figcaption><p><strong>Figure 14:</strong> Screenshot of Mechanical properties page for Xegreen polymeric material with available conditions and assigned condition parameters</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Parameters assigned to material, material description, or condition level can not be deleted until the connected data is removed.

Setting parameter visibility is not required for parameters used at the "Material" and "Material Description" levels.

Only parameters in the form of drop-down list could be used to filter data.

Parameters cannot be deselected from previously assigned property and material groups if released materials have connected data.
{% 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/parameters.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.
