> For the complete documentation index, see [llms.txt](https://docs.abtasty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abtasty.com/recommendations-and-merchandising/concepts/smart-tags.md).

# Smart tags

Smart Tags let you manually group catalog items under custom labels and reuse those groups as filters in your recommendation strategies. Instead of maintaining hardcoded product lists or complex feed rules, you define a tag once and apply it across any number of customizations.

### How Smart Tags work

When you create or update a Smart Tag, related products will be enriched with this new tag automatically. The smart tag appears in the catalog alongside other fields and can be used in the strategy builder.

{% hint style="info" %}
Smart Tags are not immediately visible in the catalog after creation or update. They appear once the automatic catalog synchronization has been completed, which can take up to a few hours.
{% endhint %}

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

### Managing Smart Tags

#### Create a Smart Tag

1. Navigate to **Catalog > Manage Catalog > Smart Tags**.
2. Click **New Tag**.
3. Enter a name
4. Upload a CSV list of item ids to tag

   **CSV format requirements:**

   \- One column (optional header row)

   \- Each row contains a single product ID.\
   [Download the CSV template](https://drive.google.com/uc?export=download\&id=1pjNmJU_5KdpOPgMnz4XHtzHHYXeHJU7g)

Only items whose IDs match existing catalog entries are added to the tag. Any unrecognized IDs are silently skipped.

#### Rename a Smart Tag

1. In **Catalog > Smart Tags**, click the tag you want to rename.
2. Edit the name inline and save.

The updated name is propagated automatically to all related items at the next synchronization.

#### Delete a Smart Tag

1. In **Catalog > Smart Tags**, select the tag.
2. Click **Delete** and confirm in the modal.

{% hint style="danger" %}
Deleting a Smart Tag doesn't remove it from existing strategies and customizations. Review which strategies reference the tag before deleting it.
{% endhint %}

### Using Smart Tags in the strategy builder

Smart Tags are available inside any **Customization** in the strategy builder.

1. Open a strategy and navigate to a Customization.
2. In the filter panel, select **Smart Tag**.
3. Choose the tag you want to filter on.
4. Save the customization.

The Smart Tag can be used across multiple strategies and customizations at the same time.

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

### FAQ

**Does a Smart Tag appear immediately after I create it?**\
No. Smart Tags require a catalog synchronization to become visible. The sync is triggered automatically when you create or update a tag.

**Can I apply the same Smart Tag across multiple strategies?**\
Yes. Smart Tags are reusable across any number of strategies and customizations.

**What happens to a Smart Tag if I re-import my catalog?**\
Smart Tags are preserved for items whose product IDs match the re-imported catalog. Items that no longer exist in the re-imported catalog lose their tags.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.abtasty.com/recommendations-and-merchandising/concepts/smart-tags.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.