The Item Tagging feature enables rep groups and manufacturers to assign predefined tags to items. These tags improve product discoverability by making items searchable and visibly labeled on the B2B storefront.
Tags are now visible on the B2B item listings Items can be searched and filtered by tag name on both the web app and B2B website Only predefined, enabled tags are available for assignment and search Tags can be assigned individually or in bulk Items support one tag at a time; assigning a new tag replaces the existing tag.
How to Manage Tags
Bulk Update
Navigate to Items->Tags
Click Assign Item Tag
You can move Unassigned items to Assigned by clicking the check box next to the item, and clicking the Assign button.
To remove items from a tag. The process is reversed. Click the checkbox next to the item and then click Delete.
Assign Items Individually
When viewing an item, you can use the drop-down menu for tags, and assign a tag. When updating a tag, the previous tag will be removed. Only one tag can be assigned to an item.
Other options to update
Item tags can also be added/edited via the Public API and Item Import.
Endpoints |
Descriptions |
| /v1/{whoAmI}/items/get | You can filter the items response using itemTagId and itemTagName |
| /v1/{whoAmI}/items/manufacturer-tags/upsert | Inserts a new manufacturer item tag or updates an existing one if it already exists. |
| /v1/{whoAmI}/items/manufacturer-tags/get | Retrieves a comprehensive list of all Manufacturer Item Tags associated with the context. |
Available Tags
| Promotions & Status | Seasonal Holidays | Occasions & Gifts | Other |
|---|---|---|---|
| New | Easter | Birthday | Made in USA |
| Bestseller | Christmas | Anniversary | Men |
| Promo | Valentine | Wedding | Women |
| Clearance | Mother's Day | Gift | Custom |
| Closeout | Father's Day | ||
| On Sale | Spring | ||
| Summer | |||
| Fall | |||
| Winter |
*These are all the currently available tags. There are no other available tags, and currently there will not be any additional tags added.
FAQ
Q: What is Item Tagging?
A: Item Tagging lets Rep Groups and manufacturers assign predefined labels (like "New," "Bestseller," "Clearance," "Holiday," etc.) to items. These tags make products easier to find via search and visually labeled on the B2B website
Q: What tags are available?
A: Tags are predefined and system-controlled. The available tags include: New, Bestseller, Promo, Clearance, Closeout, On Sale, Holiday, Easter, Christmas, Valentine, Mother's Day, Father's Day, Spring, Summer, Fall, Winter, Birthday, Anniversary, Wedding, Gift, Made in USA, Men, Women, and Custom.
Q: Can I create my own custom tags?
A: No. Tags are predefined by the system. You cannot create, rename, or delete tags — only enable/disable and assign the existing ones.
Q: Can I assign multiple tags to a single item?
A: No. Each item can only have one tag at a time. Assigning a new tag will overwrite the existing one.
Q: What happens to the tags I have already saved for my item?
A: Saved tags are migrated to the new Keywords field, with up to 10 keywords retained for each item.
Enabling & Using Tags
Q: Why don't I see any tags on my B2B website?
A: Tags must be enabled before they appear. Even if a manufacturer has assigned tags to items, the repgroup must also enable those tags on their end for them to be visible and searchable on the B2B site. Tags must have assigned items before they are visible during order writing and on the B2B website.
Q: Where do I enable tags?
A: Repgroups go to Maintenance → Tags. Manufacturers go to Items → Tags. From there, click the Enable button (it turns blue when active).
Q: A manufacturer assigned tags to items, but I don't see them. Why?
A: The tag will appear as "disabled" on your repgroup's tag list until you enable it yourself. You'll be able to see how many items the manufacturer assigned, but the tag won't be visible in B2B or during order entry until you enable it.
Assigning Tags
Q: Can I assign tags in bulk?
A: Yes. Click Assign Item Tag, select the items you want, and assign them to a tag.
Q: Can a repgroup tag items that belong to a manufacturer?
A: No. Repgroups cannot apply or remove tags on items managed by a manufacturer. Only the manufacturer can tag their own items.
Q: What happens if I assign a new tag to an item that already has one?
A: The new tag replaces the old one. Items can only have one tag at a time.
Visibility & Search
Q: Where do tags appear on the B2B website?
A: Tags appear as labels on items and are available as a filter in the Tags dropdown. Customers can also search by tag name in the search field.
Q: Can I hide tag labels for a specific manufacturer's items?
A: Yes. There is a Show Tags setting per manufacturer that is enabled by default. Disabling it hides tag labels on all of that manufacturer's items on the B2B website. Note: this is all-or-nothing per manufacturer — you cannot selectively hide individual tags.
Q: Do tags show up during order writing?
A: Yes. Enabled tags with assigned items appear on the Search Items page when writing an order in the web app.
API & Item Import
Q: Can I assign tags via the API?
A: Yes. Use the /v1/{whoAmI}/items/manufacturer-tags/upsert endpoint to insert or update manufacturer item tags. You can also filter items by tag using itemTagId or itemTagName parameters on the /v1/{whoAmI}/items/get endpoint.
Q: What happens if I provide an invalid tag during an API call?
A: For single-item insertions, the system throws an error and blocks the operation. For bulk imports, the item with the invalid tag is skipped, and the rest of the batch continues processing.
Q: What happens if the tag column is empty during a bulk import?
A: If the tag field is empty for an item that already has a tag, the existing tag is deleted. However, if you're using the UI Bulk Import and the tags column is not included in the file at all, no tags are deleted or updated.
Limitations
Q: Does this feature work for manufacturers and repgroups with a 1:1 relationship?
A: Not currently. The initial MVP does not support 1:1 manufacturer-repgroup relationships due to limitations in the database structure. This will be evaluated for a future release. Repgroup linked to only self-managed manufacturers will also not be able to access this feature. The tags field on the item details page is greyed out. This will be evaluated for a future release.