---
updatedAt: 2026-10-29T13:30:10.000Z
agentTools:
  projectIndex: https://docs.esputnik.com/llms.txt
---

# Adding Tags

<HTMLBlock>{`
<p align="right" style="color: gray;">
  <a href="https://docs-ua.esputnik.com/docs/stvorennya-mitok-v-listah" style="color: gray; text-decoration: none;"><em>
    Read this article in Ukrainian ⮕
  </em></a>
</p>
`}</HTMLBlock>

Tags are a tool for conveniently managing elements of marketing campaigns, such as messages, workflows, segments, and reports.

Tags are labels that help you to:

* Filter and search for items by categories (for example, **promo**, **trigger**).
* Create categories for contact segments and track their relevance.
* Filter reports to preview statistics on a particular category by channel (for example, email).
* Setup a [frequency strategy for broadcasts](https://docs.esputnik.com/docs/how-to-make-a-campaign-using-optimal-messaging-frequency-strategy).
* Fully automate A/B testing of campaigns at every stage of user interaction.

The message list has no folders: to keep triggered emails apart from the ones you send as one-off campaigns, give them different tags and filter the list by tag.

[More about campaigns using the One from many message block >](https://docs.esputnik.com/docs/optimizing-campaigns-using-one-from-many-message-block)

There are two types of tags in eSputnik:

* **Communication tags** – used across all communication channels, reports, and workflows.
* **Segment tags** – used exclusively for contact segments.

## Creating Tags

1. Go to your account settings and select the **Tags** tab.

<Image src="https://files.readme.io/532e73b0ef0d61d7e55ae4c681ff1b83490fac5c35cdf09458e4fcdfa06ee80c-image.png" alt="Tags" align="center" width="80%" />

1. Select the tag type (**Communication** or **Segment**), click **+ New tag**, enter a name, and click **Save**.

> 📘 Note
>
> * Special characters are not allowed in tag names.
> * The maximum tag name length is 50 characters.
> * A system tag named `underperformed` is automatically assigned to messages used in the **One from many** block that have low click-through rates. <Anchor label="Learn more >" target="_blank" href="https://docs.esputnik.com/docs/optimizing-campaigns-using-one-from-many-message-block#underperformed-tag">Learn more ></Anchor>

<Image src="https://files.readme.io/4d364dcc70d0fc4d8776673b251b74121d7d4905dfd8d5a3ef06d92b0afbd464-image.png" alt="New tag" align="center" width="80%" />

You can also create and edit tags without leaving the workflow editor. Any field where a tag is selected, including the one in the **One from many** block, opens the same tag management window with the **+ New tag** button, search, filtering and sorting.

When you create a new tag, it immediately appears in the general list. The columns **Messages**, **Reports**, **Workflows**, and **Segments** will show a value of **0** until the tag is applied to an item.

<Image src="https://files.readme.io/d1bf21b6d5dd2aad48b8fc6c3ed68a2ad025b95ad9be5205a760150aa81dee34-image.png" alt="New tag" align="center" width="80%" />

## Editing/Deleting Tags

Click the edit icon to change the tag name, and save the changes.

<Image src="https://files.readme.io/6a37661d95abfc632e7d5e87de621b01ff4cde9d1d6d5c281b497b193c1d502d-image.png" alt="Editing tag" align="center" width="80%" />

You can delete a tag from the account in two ways:

1. Click the three-dot icon, select **Delete**, and confirm the action.

<Image src="https://files.readme.io/e484e57d0016fa936f0c005ed5a459c7e9adea7de81165a8ab15dd492f43faf6-image.png" alt="Deleting tag" align="center" width="80%" />

2. Activate the checkboxes next to the tags and click the **Delete** button. This method allows you to delete multiple tags at once.

<Image src="https://files.readme.io/e35d3ced61b43116c40588527e8ab13b713af36a6c8b1014a8d10b4dc4647f9b-image.png" alt="Deleting tags" align="center" width="80%" />

## Searching, Filtering, Sorting

Tags are searched by name and only within the selected category — tags created for contact segments will not be visible in the **Communication tags** tab.

<Image src="https://files.readme.io/7991eb3519c8b49f9f59f66bd2c9a748801bbaf025886a961e38dbfc5fdb3033-image.png" alt="Search" align="center" width="80%" />

Filtering by usage allows you to view only the tags that are applied to items, or conversely, only those that are currently unused. By default, all tags are displayed.

<Image src="https://files.readme.io/a8b25c89368c5d26a2bf6dd930c7c71f39cb061a21b50827b357b34385d9eb4c-image.png" alt="All" align="center" width="80%" />

If needed, sort the tags by update date, name, or frequency of use in messages, reports, workflows, and segments.

<Image src="https://files.readme.io/444201fce4bb12928c9acdbf2aa17245f784c128a0792e799c0a555b4121cebd-image.png" alt="Filter" align="center" width="80%" />

## Adding/Removing Tags

Tags can be added or removed in two ways:

1. In the settings of messages, reports, workflows, and segments.
2. Via the lists.

### Messages, Reports, Workflows, and Segments

#### Emails

In the **Message Settings** panel, in the **Tags** section, select a tag from the list or create a new one.

<Image src="https://files.readme.io/4446206fd49cf8700e5470b64499a2865ea9da4b8ad125c4844b7091ea00bad3-image10.png" align="center" width="80% "  alt="Email editor's Message Settings panel with the Tags section highlighted" />

#### Short messages, reports, workflows, segments

The process of adding tags is the same for all elements: each has a tag field. Find this field and click **Add tag**.

> 📘 Note
>
> * You can add multiple tags for convenience.
> * To create a new tag, enter its name — it can be a word, a short phrase, a number, or a combination of letters — and press **Enter**.
> * Added tags will appear next to the items in the general list.
> * To sort out all the items with required tag, simply click any tag.
> * In a [multilingual message](https://docs.esputnik.com/docs/multilanguage-overview), tags are managed in the default version only. Tags added there apply to all language versions of the message automatically, and the tag field isn't editable inside an individual language version.

If a tag is no longer relevant or needs to be replaced, click the **x** icon next to it.

<Image src="https://files.readme.io/fbb6326088440bdeba6e9e0cb7e8ec8e643fc4bb7ec09f4f7256b90046c1f161-image11.png" align="center" width="80% "  alt="Workflow's One from many message block with a tag and its remove icon highlighted" />

### Lists

allows you to modify tags for multiple items simultaneously, making management easier and enabling quick changes without editing each item individually.

Let’s look at an example of adding tags in an email message list.

1. Open the list.
2. The buttons **Add tags** and **Remove tags** (if tags are already added) will appear after selecting the checkboxes. Choose the desired action, select the tags, and click **Add**.

<Image src="https://files.readme.io/9d237d7f00cf4bbc639f411a0c5a6c512ea31f7a5d886915a2030c48059c8af1-image12.gif" alt="Lists" align="center" width="80% " />

The changes will be applied to the selected messages.