Tags

A tag is a label that you attach to a contact or a device. Use tags to group your audience by a shared trait, such as a loyalty tier, an interest, or a past action. After you tag your audience, you can use the tags to build segments and personalize campaigns.

This guide explains how to find, create, review, update, and delete tags on the Tags page.

Before you begin

You need a Dengage account with permission to view and manage tags.
To open the page, go to Audience > Tags.

Tag types

The Tags page has two tabs: List & Key Value and Smart Tag. Dengage supports three tag types.

Tag type	What it is	Example
List	A simple label with no value. A contact or device either has the tag or does not have it.	VIP, FootballFan
Key Value	A label that stores a value for each contact or device. You can assign Key Value tags from the SDKs.	birth_year = 1977, favorite_food = hamburger
Smart Tag	An AI-assisted tag that Zeki recommends for your data. You manage Smart Tags on the Smart Tag tab.	See SmartTag with ZekiAI.

This guide covers List and Key Value tags. For Smart Tags, see SmartTag with ZekiAI.

📘
Tags and segments are different
A tag is a static list. Its members change only when you add or remove them. A segment is a dynamic query. Its members change on their own as contacts start or stop matching the segment rules.

View and find tags

The List & Key Value tab lists every List and Key Value tag in your account. The page shows 20 tags at a time. Use the page numbers under the table to move between pages.

The Tags page in Dengage with the List and Key Value tab open, showing the search box, the Filter button, the New button, and a table of tags. — *The Tags page lists all List and Key Value tags*

Table columns

Column	Description
Name	The tag name. If the tag has a description, the description appears under the name. Select the name to open the tag.
Type	The tag type: List or Key Value.
Properties	Icons that show the audience type of the tag: a person icon for Contact Specific and a device icon for Device Specific.
Last Edited On	The date and time of the most recent change.
Last Edited By	The user who made the most recent change.
Created By	The user who created the tag.
Sync	A sync icon appears for List tags.
Created On	The date and time when the tag was created.

Search for a tag

Select the Search box above the table.
Enter all or part of the tag name.

The table shows only the tags that match your entry.

Sort tags

Select a column header to sort the table by that column. Select the same header again to reverse the order. A blue highlight marks the active sort column. You can sort by Last Edited On. By default, the table shows the most recently edited tags first.

Filter tags

Select Filter. The Filter window opens.
In Type, select All, List, or Key Value.
In Date Range, select a date range. Then choose whether the range applies to the update date or the creation date.
Select Apply.

To remove the filters, open the Filter window and select Clear Filter. To close the window without changes, select Cancel or Close.

Create a tag

On the Tags page, select New. The Select a type window opens.
Select List or Key Value. The New Tag page opens.
Complete the fields. See the field reference that follows.
Select Save.

To leave the page without saving, select Cancel or the back arrow next to the page title.

The Select a type window with three cards: List, Key Value, and Smart Tag. Each card has a short description of the tag type. — *Select the tag type before you enter the tag details.*

🚧
Tag name and type are permanent
You cannot change the tag name or the tag type after you save the tag. Check both before you select Save.

Field reference

Field	Applies to	Description
Tag Name	List, Key Value	A unique name that identifies the tag in Dengage. Use a name that describes the group, for example VIP or favorite_food.
Tag Type	List, Key Value	Shows the type that you selected in the Select a type window. This field is read-only.
Value Type	Key Value	The data type of the value that the tag stores: TEXT, INTEGER, DECIMAL, EMAIL, PHONE, DATE, DATETIME, or BOOLEAN. The default is TEXT.
Description	List, Key Value	Optional. Explain the purpose of the tag so that teammates know when to use it.
Audience Type	List, Key Value	Contact Specific tags apply to a contact. Device Specific tags apply to a single device. For a List tag, select one option. For a Key Value tag, select one or both options.
Enable Realtime Tag Sync	List	Turn on this toggle to add the tag to the real-time cache of your account. The real-time cache is fast storage that on-site and in-app campaigns read while a visitor is active. With sync on, you can target visitors by this tag during their session.

The New Tag page for a List tag with the Tag Name field, the Tag Type set to List, the Description field, the Audience Type options Contact Specific and Device Specific, and the Enable Realtime Tag Sync toggle. — *The New Tag page for a List tag.*

The New Tag page for a Key Value tag with the Tag Name field, the Tag Type set to Key Value, the Value Type drop-down list set to TEXT, the Description field, and the Audience Type checkboxes Contact Specific and Device Specific. — *The New Tag page for a Key Value tag includes the Value Type field.*

View and update a tag

To open a tag, select its name on the Tags page. The tag page has two tabs: Details and Audience.

Details tab

The Details tab shows the tag settings. You can change the following settings:

Description: Add or edit the description.
Enable Realtime Tag Sync: Turn the toggle on or off. This setting applies to List tags.

The Tag Name, Tag Type, and Audience Type fields are read-only. To save your changes, select Update.

The Details tab of a List tag with read-only Tag Name, Tag Type, and Audience Type fields, an editable Description field, the Enable Realtime Tag Sync toggle, and the Delete and Update buttons at the top right. — *The Details tab shows the tag settings. Only the description and the sync setting are editable.*

Audience tab

The Audience tab lists the contacts that have the tag. The number next to the tab name shows how many members the tag has. The table includes the following columns: Contact Key, Name, Surname, Email Address, Phone, and Value. For Key Value tags, the Value column shows the value stored for each contact.

If no contact has the tag yet, the tab shows the message "No items found".

The Audience tab of a tag with a member count next to the tab name and a table with the columns Contact Key, Name, Surname, Email Address, Phone, and Value. — The Audience tab *lists the contacts that have the tag.*

Delete a tag

On the Tags page, select the tag name to open the tag.
Select Delete at the top right of the page.
Confirm the deletion.

❗️
Deleting a tag is permanent
Deleting a tag removes it from your account and from every contact and device that has it. You cannot undo this action. Before you delete a tag, check that no segment or campaign uses it.

Frequently asked questions

When do I use a List tag, and when do I use a Key Value tag?

Use a List tag when membership alone is enough, for example VIP. Use a Key Value tag when you need to store a detail for each contact, for example birth_year = 1977.

Can I rename a tag or change its type?

No. The tag name and the tag type are permanent. To use a different name or type, create a new tag.

What is the difference between Contact Specific and Device Specific?

A Contact Specific tag follows the contact across all of their devices. A Device Specific tag applies to one device only, which is useful for visitors who have not logged in.

When do I turn on Enable Realtime Tag Sync?

Turn it on when an on-site or in-app campaign needs to target visitors by a List tag during their session.