# Labels

## **Difference between Labels, Tags, and Collections**

*Labels* allow users to organise their assets in a more structured and permanent way than *Tags*. Unlike the dynamic Collections whose assets change through applicable filters, they are static and are similar in principle to the labels on physical products (drinks, foods, clothes).

Users can still modify a given label and/or change which assets fall under it.

The system also allows users to view and search the labels and their applicable assets.

## Labels View

The Labels page can be accessed from the DAM sidebar menu.

<figure><img src="/files/sLu26kourqLfThpIRVCV" alt=""><figcaption></figcaption></figure>

## Managing labels <a href="#managing-labels" id="managing-labels"></a>

### Creating labels <a href="#creating-labels" id="creating-labels"></a>

You can create named, colour-coded labels by clicking on `+ Add label` button. This allows you to list and place all assets assigned to a specific label in a single view.

<figure><img src="/files/G9DTN0DIIGDpzFsFnkIK" alt="" width="305"><figcaption></figcaption></figure>

* **Title** - please choose a meaningful name for your new label
* **Colour selector** - choose a color by clicking a pre-defined color or by entering an RGB code manually.
* **Pinned** - if this checkbox is marked, then the new label will appear on the top of the labels list. On *Sort* the system will sort first the Pinned labels and then will show the other ones.

### Editing labels <a href="#editing-labels" id="editing-labels"></a>

To manage labels, click the 'Settings' icon in the left panel. This opens the Configuration window.<br>

<figure><img src="/files/OPMEr5iOc28SXnkr1zyk" alt="" width="302"><figcaption></figcaption></figure>

That will open the "Manage labels" window where you have options to Search, Add new labels, Edit the current configuration or Delete existing labels.

<figure><img src="/files/v77ya1sGo3FvcBaQRTjk" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you want to delete a label, it is a good practice to ensure that the number of the current assets assigned to it, is "0".
{% endhint %}

### Attaching a label to an asset

Right-click on an asset (or multiple selected assets) and choose the *'Manage' > 'Labels'* submenu to search for and apply a label.

<figure><img src="/files/G2M2QPCoPCMnv6FTICcm" alt=""><figcaption></figcaption></figure>

If no exact match is found during the search, the user can create a new label and apply it to the asset immediately.\ <br>

<figure><img src="/files/D6o5ztZMHtGFhzbYowBy" alt="" width="220"><figcaption></figcaption></figure>

### Detach a label from an asset

This function is available on the Labels page when selecting a file and opening its context menu:

<figure><img src="/files/rQl1D9TY2rgyrD10tz0H" alt=""><figcaption></figcaption></figure>

The user can select multiple files too and use the `...` icon in the Navigation bar in order to access the same option.

In both cases, the user should have a Developer, Manager, Admin, or Owner User Level to detach a label.

## Searching labels

### Searching for an asset by a specific label <a href="#searching-for-an-asset-by-a-specific-label" id="searching-for-an-asset-by-a-specific-label"></a>

You can search by specific search criteria inside the pool of all assets assigned to a specific label, using the main Search box:<br>

<figure><img src="/files/7FUtCcJD9Yhf7VFN0pli" alt=""><figcaption></figcaption></figure>

### Searching for a Specific Label

If you are interested in finding all assets assigned to a specific label, you can search for this label's name in the Search box at the left panel and then click on the result.

<figure><img src="/files/HFirXLaPx2JuQbaACRGI" alt=""><figcaption></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.scaleflex.com/digital-asset-management-dam/library/labels.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.
