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.
Rep Groups can only manage the tags of agency managed manufacturers. Rep Groups can not edit tags for Manufacturer managed items.
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.
Managing Item Tags
Enable/Disable Item Tags
Select the +/- button on the Tags Management page to enable/disable individual tags.
Bulk Update
Navigate to Maintenance->Tags
Click on Assign Item Tag
You can select the manufacturer (or view all manufacturers) to filter items. Check the box next to the items you would like to add, click the Assign button to move them to the Assigned Items area.
To remove items, select the checkbox next to items you would like to remove, and click the Delete button.
Assign Tags Manually
When viewing an item, open the Tags drop-down and select the Tag you would like to assign.
Other Ways to Assign Tags
Item Tags can be added via the Item Import Process via the Public API
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.
Tags and Your B2B
Enable/Disable Tags on Your B2B
Using the Manufacturer List on your B2B Settings page, you can enable/disable Tags for each Manufacturer individually. Tags are enabled by default.
How Tags Appear on Your B2B site.
The assigned item tag will show next to the item image in search.
When viewing an item.
There is also a Tags menu at the top of your B2B site.
Tag Usage for Order Writers
When writing an order, there is a Tags drop-down on the Basket tab. This will show all items (from all Manufacturers) with the selected Tag. You can also filter by manufacturer by selecting a manufacturer using the Select Manufacturer drop-down.
You can also use the Tags drop-down on the Search Items tab.
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.