# Products

## Overview

The Product feature helps you organize and quickly find files by grouping them using specific product references. Once enabled, users can add two new metadata fields—**Product Reference** and **Product Position**—to their assets.

Marking assets with Product References makes it easy to locate materials for seasonal promotions or product launches.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FU7DxOLOagDR9zo2mwqw5%2Fimage.png?alt=media&#x26;token=0852eb47-8891-46e1-9792-7cb50eaefb40" alt=""><figcaption></figcaption></figure>

## Enabling Products

To enable this feature, navigate to [**Settings > DAM > Library > Featured Components**](https://hub.filerobot.com/settings/dam/library/featured-components) and turn on the **Products** feature to automatically add the **Product Reference** and **Product Position** fields.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2Fm5xoDKwjFWcGfYN0NC8H%2Fimage.png?alt=media&#x26;token=292eeed3-50c8-459d-a5ed-0992a4d8b552" alt=""><figcaption></figcaption></figure>

## Creating and Deleting Products

A product will appear in the **Products** view only if at least one asset has this Product as assigned in its **Product reference** field.

Products are automatically removed from the **Products** view when no assets are associated with them.

## Assigning Product Metadata to Assets

To add Product metadata to an asset:

1. Select the asset
2. Open the Details view
3. Go to *Metadata > Custom*
4. Click the Edit button
5. Add or update the **Product reference** and **Product position** fields.
6. Save the changes.

{% hint style="info" %}
You can configure an uploader script to [assign product metadata](https://developers.scaleflex.com/#2dd93fbb-e4db-4859-ac2f-c97849a201ca) during upload automatically.
{% endhint %}

**Product Reference** identifies the specific product to which the asset is related. \
**Product Position** specifies the order in which assets appear within a product group. For example, it determines the sequence of images in a promotional campaign.

### Removing Product metadata from an Asset

To detach product metadata from an asset:

1. Select the asset and open the **Details view**.
2. Navigate to **Metadata > Custom**.
3. Click the **Edit** button.
4. Clear the **Product reference** and **Product position** fields.
5. Save the changes.

##

## Using the Products view

The list of Products can be found at **Menu > Products** (the Product view).&#x20;

All users can see the products in this View, as long as it is [enabled from the configuration settings](#enabling-products) and there are assets associated with the products.

The **Product Position** value of an asset determines the order of the files in the detailed view when a Product is selected.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FH7ZtP6f4c3zfYoLgEWnV%2Fimage.png?alt=media&#x26;token=e8b4d1ad-5c7d-4b56-8c57-aae5ad93856f" alt=""><figcaption></figcaption></figure>

## Searching for products

### Product Filter

Use the **Products** filter in the search bar to find assets:

* **Search by single reference:** Enter one product reference to retrieve its associated assets

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FfvXypQSti0YEZRspfigm%2Fimage.png?alt=media&#x26;token=48219490-7094-4106-9282-a33e8e4de69b" alt=""><figcaption><p>Single Product_reference serach</p></figcaption></figure>

* **Bulk reference search:** Use the **Add List** option in the filter to paste multiple references (one per line). The system will automatically format the input and display results for all referenced products.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FqS0VHmCl5eOmG6KaUlGI%2Fimage.png?alt=media&#x26;token=6b176b32-d05a-4622-bf31-8c0ba59c1ee6" alt=""><figcaption><p>Bulk Product reference search</p></figcaption></figure>

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FzFPHZ3KYE2n1dTMY1zmW%2Fimage.png?alt=media&#x26;token=09ac87d4-25d9-45a6-bf9b-bc22ec39e34f" alt=""><figcaption><p>Exact result</p></figcaption></figure>
