Skip to main content
Products

Categories

Organize your product catalog with categories, control visibility with the Listed toggle, restrict who can add products, restrict access with company whitelists, preview which storefront categories a company can see, and set ConnectWise defaults on subcategories.

Written By Victor Raessen

Last updated 12 days ago

Categories group your products into a two-level hierarchy: root categories and subcategories. Products belong to subcategories. Categories also carry default pricing settings (markup and RRP discount), optional add-ons, and visibility rules that control who sees which parts of your catalog.

Navigate to Products β†’ Categories to view, create, and edit categories. Click the pencil icon on a category to open the Manage Category dialog.

Category order

New root categories and new subcategories appear at the bottom of their list. Categories that have never been dragged or A–Z sorted stay below categories that already have a saved position. The order stays as you left it until you drag a category to a new position or use the A–Z sort on a root.

Use Sort by: As configured to see that saved order. Drag and drop is available only when search, listed filters, and name sort are cleared.

Storefront categories tab

When your account uses storefront categories and the Storefront feature is enabled, Products β†’ Categories shows two tabs:

  • Product categories β€” the internal categories products belong to
  • Storefront categories β€” the categories customers browse on the storefront

When the Storefront feature is turned off, the Storefront categories tab is hidden. The page shows product categories only, even if storefront categories were set up earlier. See Storefront for how customers browse those categories.

Listed and unlisted categories

Every category has a Listed toggle on the Settings tab of the Manage Category dialog. Listed categories are visible to everyone who is allowed to see that part of the catalog. When you turn Listed off, the category becomes unlisted.

Unlisted categories are a staging tool: you can prepare categories and assign products before making them visible to your wider team or customers.

Who can see unlisted categories?

Only users with product management permission can see unlisted categories. This is not limited to admin users β€” any user role that includes product management permission can view and work with unlisted categories.

Everyone else β€” including users with quote management permission alone β€” does not see unlisted categories in category pickers, the product catalog, or the storefront.

When a root category is unlisted, all of its subcategories are hidden as well, even if those subcategories are individually marked as listed.

How to tell if a category is unlisted

On the Products β†’ Categories page, unlisted root categories show an Unlisted badge. Use the Filter dropdown and choose Unlisted to review all unlisted categories in one view.

ConnectWise defaults on a subcategory

When ConnectWise is connected, each subcategory can set a ConnectWise product type. Every subcategory can also set a procurement default. On the new design, open the subcategory and go to Pricing & systems. On the older design, the same fields are on Manage Category, under General Info. Leave either empty to keep today's behavior. Root categories do not have these fields.

ConnectWise product type chooses the ConnectWise Product Type used the first time a product in that subcategory is created in ConnectWise. The list is the product types imported with ConnectWise field sync. Use tenant default keeps Settings β†’ Integrations β†’ ConnectWise β†’ Categories β†’ Defaults β†’ Default Product Type.

The subcategory type is used only when Map product types maps that type to the same kind as the product (Product, Service, or Labor). Otherwise Salesbuildr uses the tenant default, so the next import does not turn a hardware product into a service.

Procurement default sets Does not require procurement on new products in that subcategory:

  • Use current behavior β€” new products start the way they do today
  • Does not require procurement β€” new products skip procurement
  • Requires procurement β€” new products stay in procurement

You can still change the toggle on the product. Products that already exist are not updated when you change the subcategory default. On Halo, a new product's consignable flag follows this same default.

These settings do not change which ConnectWise subcategory the product lands in. That still comes from Map categories and Map Root Category, so two Salesbuildr subcategories can still share one ConnectWise subcategory.

Product Type and Product Class are sent only when the ConnectWise item is first created. Changing the subcategory later does not update items that are already in ConnectWise. If an existing item has the wrong type or class, deactivate it in ConnectWise and contact support to clear the Salesbuildr link. There is no unlink action on the product. After the link is cleared, sync the product again so it is created with the current defaults.

The same two values are included on the public category API as productTypeFieldId (the imported field value, not the ConnectWise type id) and defaultDoesNotRequireProcurement.

Company whitelisting

You can restrict which customer companies see a category by adding companies to the Company Whitelist or company classifications to the Classification Whitelist on the Settings tab. When no whitelist is configured, the category is visible to all companies (subject to the Listed toggle above).

Whitelisting is commonly used on the storefront to show different product lines to different customer segments. See Storefront for inheritance rules and storefront-specific behavior.

Who bypasses whitelist restrictions?

Users with quote management or product management permission always see all listed categories, regardless of whitelist settings. This lets your sales and product teams browse the full catalog while customers only see categories whitelisted for their company.

Whitelist bypass does not reveal unlisted categories β€” those remain visible only to users with product management permission.

Only admins can add products

A subcategory can be set so that only an admin may add products to it. In the current category dialog, open the subcategory, then the Pricing & systems tab, and turn on Only admins can add products to this category. In the legacy category dialog, use the Settings tab. Only an admin sees that toggle, and only an admin can turn it on or off. Other category edits stay available to users with product management permission.

What a product editor who is not an admin can do:

  • Save a product that is already in that subcategory, including changes to price, name, and the other fields.
  • Remove that subcategory from the product.
  • They do not see the subcategory in the product category picker, so they cannot add it from create, edit, bulk edit, or create by MPN.

An admin can still add and remove the subcategory from a product.

Preview which storefront categories a company sees

On the Storefront categories tab you can pick a verified company and see the same storefront tree that company's contacts see, without logging in as that customer.

  1. Go to Products β†’ Categories and open the Storefront categories tab. The same Visible for company picker is on the new design and the classic page.
  2. In Visible for company, open the list or type a name. The list is verified companies, including when the box is still empty. Clear the selection to return to the full tree.
  3. The tree narrows to the categories that company can see. Each row shows Visible because with one of these reasons:
    • By name β€” the company is on that category's company whitelist
    • By classification β€” the company's classification is on the classification whitelist
    • Inherited from the main category β€” the parent category is visible to the company and this subcategory has no whitelist of its own
    • Open to all companies β€” neither the parent nor the subcategory uses a whitelist
    • Has a visible subcategory β€” used on a root category that is shown only because at least one subcategory is visible
  4. Search, the Listed filter, and name sorting still apply on this filtered tree. Drag-and-drop reordering is turned off while a company is selected (same as when you are searching).

A root category is not shown just because it is named for the company. If none of its subcategories are visible to that company, the root is hidden β€” the same rule as the customer storefront.

If the company's type is not product-filtered, a notice explains that the company sees every listed storefront category. Unlisted categories stay on this page for administration and stay hidden on the public portfolio. The tree is not narrowed in that case.

You can also open this view from a company: on the company detail page, click Storefront categories. That opens Products β†’ Categories on the storefront tab with that company already selected. You still manage whitelists in the storefront category Settings tab β€” the company page does not edit visibility.

The picker lists verified companies only.

Summary

Setting

Who is affected

Effect

Listed toggle off

Everyone without product management permission

Category is hidden from catalog, pickers, and storefront

Listed toggle off

Users with product management permission

Category remains visible

Company or classification whitelist

Customer companies not on the whitelist

Category is hidden from their storefront view

Company or classification whitelist

Users with quote management or product management permission

All listed categories remain visible regardless of whitelist

Only admins can add products

Users with product management permission who are not admins

They can save a product already in the subcategory and can remove it. They cannot add the subcategory, and they do not see the toggle.

Only admins can add products

Admins

They can turn the toggle on or off, and they can add or remove the subcategory on a product.

Public API

When Storefront and storefront categories are enabled, integrators can manage the storefront tree, company and classification access, and a product's storefront membership through the Public API. There is no delete β€” hide a category by turning Listed off. See Public API for the routes.

See also