
Tags let you mark objects in the Synerise platform and you can use them for filtering. Tags can't be deleted.


<div class="admonition admonition-note"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg></div><div class="admonition-body"><div class="admonition-content">

For tagging profiles, use [profile tags](/docs/assets/customer-tag).

</div></div></div>


### Use of tags

- [Tagging campaigns](/docs/campaign/tagging-campaigns)   
    You can use tags from the predefined **campaigns** folder for tagging [specific campaign types](/docs/campaign/tagging-campaigns#campaigns-available-for-tagging)
- [Tagging promotions](/docs/ai-hub/promotions/promotion-tags)  
    You can use tags from the predefined **promotions** folder for:
    - [filtering promotions](/docs/ai-hub/promotions/managing-promotions#filtering-promotions) on the promotion list
    - filtering promotions in API responses
    - [creating promotion filters](/docs/ai-hub/promotions/managing-promotions#saving-filters).
- [Tagging workflows](/docs/automation/tagging-workflows)  
    You can use tags from the predefined **automations** folder for tagging workflows.
- [Managing communication limits based on tags](/docs/settings/configuration/campaign-limits)


## Adding tags

1. Go to <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/data-modeling-hub-icon.svg" alt="Data Modeling Hub icon" class="icon"> **Data Modeling Hub > Tags > Add tag**.  
    **Result**:  
    <figure><img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/assets/_gfx/adding-tags.png" class="medium" alt="A blank tag configuration form"><figcaption>A blank tag configuration form</figcaption></figure>
1. In the **Name** field, enter the tag name.  
    You can use up to 20 characters. 
2. From the **Directory** dropdown list, select the folder to which the tag will be added.  
    
   <div class="admonition admonition-note"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg></div><div class="admonition-body"><div class="admonition-content">

   To assign a tag to campaigns or use it for [managing communication limits](/docs/settings/configuration/campaign-limits), you must add it to the **campaigns** folder.

   </div></div></div>

3. In the **Description** field, you can provide the purpose of the tag.
2. By using the color picker under the **Description** field, you can change the tag's background color.
3. By clicking **Advanced options** and uploading a tag icon in the **Tag icon** section, you can add the icon to the tag.
4. In the **Priority** field (available after clicking **Advanced options**), you can also assign priority to the tag. Values from 1-100 is accepted (1 being the highest).  
    This feature is used for [filtering promotions based on tags](/docs/ai-hub/promotions/promotion-tags).
5. Save the tag by clicking **Create**. 

## Editing tags
---
Once you have added tags, you can edit them in the system at any time.  


<div class="admonition admonition-warning"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L4.082 16.5c-.77.833.192 2.5 1.732 2.5z" /></svg></div><div class="admonition-body"><div class="admonition-content">

Be cautious when changing tag names, especially if these tags are used in your integrations.

</div></div></div>


1. Go to <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/data-modeling-hub-icon.svg" alt="Data Modeling Hub icon" class="icon"> **Data Modeling Hub > Tags**. 
1. Search for a tag you want to edit using the search box marked above the tag list.
2. Next to the tag author, click <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/vtex-threedot-icon.png" alt="Three dot icon" class="icon">
3. From the dropdown list, select **Edit**.  
    **Result**: A pop-up appears.
3. Make changes to the tag settings; field descriptions are available in the ["Adding tags" section](#adding-tags).
4. Confirm changes by clicking **Save**. 

## Adding tag folders
---

Tag folders help you group and organize tags within your workspace.

When you create a workspace, predefined tag folders are available by default. These predefined tag folders are also accessible in already existing workspaces, ensuring consistency across your projects.

Predefined tag folders include:

- **automation** - for [tags assigned to workflows](/docs/automation/tagging-workflows)
- **campaigns** - for [tags assigned to communication](/docs/campaign/tagging-campaigns)
- **promotions** - for tags [assigned to promotions](/docs/ai-hub/promotions/promotion-tags)

To add a new tag folder, follow these steps:

1. Go to <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/data-modeling-hub-icon.svg" alt="Data Modeling Hub icon" class="icon"> **Data Modeling Hub > Tags**. 
2. On the left panel, click **Add folder**.  
    **Result**: Below the **Add folder** button a text field appears.
3. Provide the name of the folder.
4. Confirm the name by clicking **Enter**.

**Result**:  
The folder is created. To change its settings, for example set the folder type, see ["Edit folder settings"](#editing-folder-settings).


## Editing folder settings

1. In the list of tag folders, hover over the folder you want to edit.  
    **Result**: The folder management icons appear.
3. To open the folder settings, click the <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/settings-in-list.png" class="icon" alt= "Gear icon">  icon.
4. From the **Type** dropdown list, assign a type to the folder.  
5. If you want to edit free-form parameters of the folder:
    1. Expand **Advanced options**.
    2. Add or remove parameters.
6. Save the settings by clicking **Save**.


   <div class="admonition admonition-warning"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L4.082 16.5c-.77.833.192 2.5 1.732 2.5z" /></svg></div><div class="admonition-body"><div class="admonition-content">

   If you have assigned tags with a different value to the folder, they will be recalculated according to the value of the folder (as the folder is the parent).

   </div></div></div>



## Removing tag folders

1. In the list of tag folders, hover over the folder you want to edit.  
    **Result**: The folder management icons appear.
3. Click the <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/close-s.svg" class="icon" alt= "Red X icon"> icon.
5. Confirm by clicking **OK**.
