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.

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.

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

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.

Deleting a Smart Tag doesn't remove it from existing strategies and customizations. Review which strategies reference the tag before deleting it.

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.

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.