Categories

Category hierarchy, admin table, management dialog (5 tabs), feature groups, bulk edit, delete/reallocate, and storefront display.

Written By Victor Raessen

Last updated 4 days ago

Categories organize your product catalog into a browsable hierarchy. They drive how products appear in the catalog, product picker, and storefront — and they carry their own pricing rules, add-ons, content, and settings.

Category hierarchy

Categories follow a strict 2-level hierarchy:

  • Root categories sit at the top level and contain subcategories (e.g., "Microsoft", "Hardware", "Services")
  • Subcategories belong to a single root category — there is no third level

Products can be assigned to multiple categories, each with its own feature selections. One category is marked as the primary.

Root categories have unique properties: a color indicator, tax/VAT settings, and a category overview display mode (list or tiles). Subcategories carry markup, RRP discount, add-ons, and product specifications.

Categories admin page showing root categories (Desktops & Laptops, Firewall, Services) with subcategories and columns for Markup, Products, Add-ons, Listed, Shipping
Categories admin page showing root categories (Desktops & Laptops, Firewall, Services) with subcategories and columns for Markup, Products, Add-ons, Listed, Shipping Feb 23, 2026

The admin categories page

Navigate to Products > Categories (requires the product.manage permission) to manage your category structure.

Toolbar

  • Create new root category — Requires a PSA connection to be configured
  • Manage dropdown — Bulk edit selected / Bulk delete selected
  • Search — Filter across root and subcategory names
  • Filter — Listed / Unlisted / All
  • Sort — As Configured (manual order) / Name A→Z / Name Z→A

Category table

Each root category expands to show its subcategories. The table columns:

ColumnDescription
Drag handleReorder categories (disabled when searching or sorting)
NameCategory name with optional PSA mapping tag (Halo Product Group, ConnectWise subcategory, Autotask billing code)
WhitelistFilter icon with count if company whitelist is configured
AvailabilityWhether product availability is hidden; menu to toggle for all products
Markup %Per-category markup percentage (or "using default" if not set)
RRP Disc %Per-category RRP discount (or "using default" if not set)
ProductsProduct count, linked to the category storefront page
Add-onsAdd-on count; click to open the manage dialog on the Add-ons tab
ListedGreen checkmark or red X
ShippingGreen checkmark or red X
ActionsEdit (pencil) and Delete (trash)

Root category rows also have: Add subcategory (+), Alphabetic sort for child ordering, and Delete (disabled if the root still has children).

Admin categories table with Desktops & Laptops expanded showing HP Laptops, HP Elitebooks, Lenovo, Dell, and other subcategories with markup percentages, product counts, and add-on counts
Admin categories table with Desktops & Laptops expanded showing HP Laptops, HP Elitebooks, Lenovo, Dell, and other subcategories with markup percentages, product counts, and add-on counts Feb 23, 2026

The category storefront page

Navigate to the customer-facing category page (requires the Storefront feature). Two view modes:

  • Tiles — Card grid with image, name, description, product count, and color indicator
  • List — Compact table with name and product count

The view mode is set globally at Admin > Site > Storefront and can be overridden per root category.

Browsing a root category shows its subcategories. Browsing a subcategory shows its products.

Note: Non-admin users see a "Not Found" page if the category tree is empty.

Managing a category

Click a category (or click Create New) to open the category management dialog. The dialog has five tabs. Some fields only apply to root categories, others only to subcategories.

General Info

FieldRootSubDescription
Parentread-onlyShows [root] or the parent name
NameyesyesRequired. Auto-generates a URL slug
ColoryesHex color picker for the category indicator
DescriptionyesyesRich text (HTML) shown on the category page
Category imageyesyesImage upload for card views and storefront
Short descriptionyesyesPlain text for category cards (auto-fills from description if empty)
Billing codeyesAutotask billing code mapping (Autotask only)
Asset typeyesHaloPSA asset type mapping (HaloPSA only)
Cost centeryesyesInternal cost center assignment
TermyesyesDefault billing term for products
Default markupyesOverride the site-wide markup for this category's products
Default RRP discountyesOverride the site-wide RRP discount
Shipping typeyesAuto-apply this shipping type on quotes
Category overview displayyesDefault / List / Tiles (root only; overrides global setting)
Category management dialog - General Info tab showing Parent, Name, Color picker, Description, and Category image fields
Category management dialog - General Info tab showing Parent, Name, Color picker, Description, and Category image fields Feb 23, 2026

Add-ons (subcategories only)

Configure product add-ons at the category level. When a sales rep adds a product from this category to a quote, they are prompted with the configured add-on products.

Category-level add-ons apply to all products in the category. Individual products can also have their own add-ons on the product detail page.

Category management dialog - Add-ons tab for configuring product add-ons that appear when sales reps add products from this category to a quote
Category management dialog - Add-ons tab for configuring product add-ons that appear when sales reps add products from this category to a quote Feb 23, 2026

Content

Configure marketing content displayed on the category page in the storefront. Toggle Show content to enable.

FieldDescription
PlacementAbove products or beneath products
ContentRich text (HTML)
ImageFeature image upload
Image alignmentLeft or right
ButtonsTable of CTA buttons with label, link, and color (Primary / Secondary / Ghost)
Button alignmentLeft / Center / Right (when a single button)

This lets you build a branded category landing page for your storefront without editing code.

Category management dialog - Content tab with Show content toggle, Placement dropdown, rich text editor, image upload, and CTA button configuration
Category management dialog - Content tab with Show content toggle, Placement dropdown, rich text editor, image upload, and CTA button configuration Feb 23, 2026

Product specifications (subcategories only, when editing)

Lists all product specifications present across the category's products. For each specification:

  • Toggle it as a visible filter on the storefront page
  • Preview the top values for that specification

When specifications are enabled as filters, customers browsing the storefront can narrow products by technical attributes (e.g., RAM, storage, screen size).

Note: This tab only appears when editing an existing subcategory, not when creating a new one.

Category management dialog - Product specifications tab showing specification groups (AC Adapter, Accu/Batterij, Audio) with toggle controls for enabling each as a visible storefront filter
Category management dialog - Product specifications tab showing specification groups (AC Adapter, Accu/Batterij, Audio) with toggle controls for enabling each as a visible storefront filter Feb 23, 2026

Settings

SettingRootSubDescription
Quote descriptionyesyesRich text appearing on quote line items for products in this category
Hide out-of-stockyesyesHide products with no available stock
ListedyesyesVisible to end customers on the storefront
Hide availabilityyesHide stock/availability indicators
Product image as primaryyesUse the product image instead of the vendor logo
Company whitelistyesyesRestrict visibility to specific companies
Classification whitelistyesyesRestrict visibility by company classification tier
Admin-only product addingyesOnly admins can add products to this category
Price decimalyes2 or 4 decimal places
TaxableyesUse default / Yes / No
VAT/Sales Tax rateyesSelect a tax rate (only when Taxable = Yes)
Category management dialog - Settings tab showing Listed toggle, Hide out-of-stock, Company whitelist, Classification whitelist, and other visibility settings
Category management dialog - Settings tab showing Listed toggle, Hide out-of-stock, Company whitelist, Classification whitelist, and other visibility settings Feb 23, 2026

Feature groups

Categories can define feature groups — custom attribute groups that structure how products are tagged within a category. Each group has:

  • A group name (e.g., "Technical specs", "Compatibility")
  • A list of feature values (sortable chips)

When a product is assigned to a category, the user selects which features from that category's groups apply to the product. These features are used for:

  • Product comparison — the comparison page shows feature checkmarks per product
  • Filtering — customers can filter by features on the storefront

Bulk editing categories

Select multiple subcategories within a single root category and click Bulk Edit. Cross-root bulk selection is not supported.

Available bulk fields (each must be toggled on to be included):

FieldDescription
Default markupOverride markup for all selected categories
Default RRP discountOverride RRP discount
Shipping typeAssign a shipping type
ListedToggle visibility
Company whitelistRestrict by company
Classification whitelistRestrict by classification
Add-onsReplace add-ons for all selected categories
Bulk Edit dialog with 10 subcategories selected showing General and Add-ons tabs, Default Markup field, Shipping Type dropdown, Listed toggle, and Company Whitelist
Bulk Edit dialog with 10 subcategories selected showing General and Add-ons tabs, Default Markup field, Shipping Type dropdown, Listed toggle, and Company Whitelist Feb 23, 2026

Deleting a category

Two scenarios when deleting a category:

  1. Empty category (no products) — Simple confirmation dialog
  2. Category has products that exist only in this category — A warning appears with a reallocate picker, prompting you to select a new category for those products before deletion

Additional rules:

  • Root categories cannot be deleted while they still have subcategories — remove all children first
  • Deletion is a soft delete — the category is marked as deleted with a timestamp
  • Products assigned to multiple categories only lose the deleted category assignment; they remain in their other categories

PSA integration mapping

The admin categories table shows PSA mapping tags inline for each category:

PSARoot category showsSubcategory shows
HaloPSAHalo Product Group nameHalo Asset Type name
ConnectWiseConnectWise subcategory (fallback)ConnectWise subcategory
AutotaskBilling code

These mappings control how products in each category are synced to your PSA. Configure them via the PSA integration admin pages (see Integrations).

Storefront settings

Global category display is configured at Admin > Site > Storefront:

SettingDescription
Category overview displayHow categories appear site-wide: List or Tiles (can be overridden per root category)
Hide product pricingWhen enabled, pricing is hidden from the storefront — customers can browse but not see prices

Categories marked as Listed appear on the storefront. Use Company whitelist and Classification whitelist on individual categories to control which customers see which product categories.

See also