# Metadata

### What is Metadata?

\
Metadata are properties of items that cannot be changed by the end user which may be used within the system for:

&#x20;

* Enhancing user experiences
* Allow the properties of a product to manipulate the visuals

&#x20;

### Add Metadata in Catalog

&#x20;

Open the catalog item and enter the edit mode.

Locate the Metadata Window and click "Add Metadata"

<img src="/files/CRpis4FHSxquqIIJj6fq" alt="" width="279">

Select either "String" or "Number"

<img src="/files/531rCeIBAMcK2kOoBZwV" alt="" width="261">

Naming Metadata

When naming your metadata be sure to avoid operator, precedence, and delimiter-style characters such as:\
, . “ ‘ ? ; : & \* ( ) - = \_ + \[ ] \ { } | ( ) # @ ! < >

String metadata allows for alphanumeric characters as well as special characters in the "Value" field.

![](/files/gXeqrIqkuUuHF4yFDKC9)

Number metadata only allows numeric characters in the "Value" field.

![](/files/bALtKDeGoprgsf886IfW)

NOTE:

At this time, all metadata is "Local."

&#x20;

### Metadata in Rules: Conditions

&#x20;

In the catalog, metadata may be used for selecting which part referenced items are modified by a rule.

* Create a new rule
* Add a condition using a part reference attribute where the items referenced contain metadata.
* Select "metadata" from the dropdown.
* Click "+ parameter."
* Type in the name of the metadata on the part reference.
* Select an appropriate operator.
* Type in the desired value.

![](/files/S8TVTAsUTpT35w4BtQx4)

&#x20;

### Metadata in Rules: Actions

&#x20;

This action allows metadata information to be passed from part referenced items into attribute values in a higher level configurator.

* Create a new rule
* Add an action of "set attribute value."
* Select the attribute that will change values
* Select "metadata" from the dropdown.
* Select "item"
* Type in the name of the metadata

![](/files/JGIOMeyUfT0qHwsX4E82)

&#x20;

Metadata values are case sensitive. Be sure to check the name if your rule does not behave as expected.

&#x20;

### Using Metadata to Modify 3D Assets

&#x20;

In the catalog item AND asset editor, ensure an attribute (global attributes are recommended) exists for each component to be adjusted based on metadata.

![](/files/vhwldDSJveycootN2AbH)

In the asset editor rules tab, select a condition for the attribute with a type of "metadata" and select whether the metadata exists on the item or the asset.

![](/files/dJKggxqso48APCPnd8wO)

Click "Parameter" to list which metadata will be utilized.

![](/files/31RZr17KlGd3X6gwJPAM)

Click the + icon for each action and select the type of value you wish to modify.<br>

<figure><img src="/files/XtgltCTso1w5bGg2rq46" alt="" width="198"><figcaption></figcaption></figure>

Multiple values may be modified on a single rule. For example, the camera, visibility of stage props, and lighting may be modified based upon item size metadata.

![](/files/X7iS3xdmJhZOK63cvOla)

### Video

{% embed url="<https://www.youtube.com/embed/cPxhFc-X1x4>" %}


---

# 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://community.threekit.com/learn/training/self-led-training/metadata.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.
