# How to build a product catalog with variants, bundles and categories

https://krokul.com/en/blog/product-catalog-variants-bundles/ · Krokul Team · Updated 2026-11-18

Krokul CRM is a B2B CRM for contract-based companies: deals, projects and profit per client in one system, implemented by integration partners. Its catalog holds goods, services and subscriptions in one tree of groups, with variants under a parent item and kits that are sold as one line.

**Short answer.** To build a B2B product catalog in Krokul, choose the kind of each item (goods, service or subscription), create a tree of groups, add variants such as size and colour under one parent item, and assemble bundles from components with a quantity. Retire an item that is no longer sold, and keep it in the documents already issued.

## When does a catalog need variants, bundles and groups?

A catalog needs this structure when the same product sells in several forms and one team has to find it in seconds. The catalog is the base of the topic of [selling from stock B2B without overselling](https://krokul.com/en/blog/topics/b2b-goods-sales/), because prices, reservations and stock all attach to its items.

- A bag comes in four sizes and three colours, and the price list has twelve separate lines that nobody can scan.
- A client buys a workstation, a laptop, a monitor and accessories, and the manager retypes five lines each time.
- A discontinued product sits next to current ones, and orders go to the wrong article.
- The same item has a different name in the price list, the quote and the warehouse.

- **Variant** — A variant is a separate catalog item under a parent item, with its own article number, price and unit, used for size, colour or volume.
- **Bundle** — A bundle is an item made of several components with a quantity for each, sold as one line or as its components.
- **Group** — A group is a node in the tree that sorts catalog items, and its path is shown as the item’s category.

## How do you build the catalog in six steps?

### 1. Choose the kind of every item first

Each item is goods, a service or a subscription, and a subscription carries a billing period of month, quarter or year. Krokul fixes the kind when the item is created and never changes it later, because stock, units and bundles depend on it.

Decide it before you import a long list. A service created as goods needs to be created again as a service.

### 2. Build the group tree

Groups form a tree of up to five levels, edited in the Product groups tab of the settings. Renaming a group rewrites its label on every item inside it, and deleting a group leaves the items in the catalog.

Keep two to three levels, for example Peripherals, Monitors, Office monitors, so that a manager finds an item by walking the tree. The panel of groups in the product list and in the deal picker uses the same tree.

![Item picker of a demo company: a panel of groups on the left, a catalog with price and available stock on the right](https://krokul.com/img/en/blog/catalog-groups-picker.webp)

### 3. Create a parent item and add variants

Open the parent item, go to the Variants tab and press the variant button. The window creates a new catalog item under the parent, with its own name, group, price and unit, and the article number is filled in the card of the variant. The product list shows only top-level items, and the variants live in the card of the parent.

The parent item is not sold. A document takes a variant, so each size and colour has its own price, stock and reservation.

> **Tip.** Name a variant by the values that tell it apart, for example 14 inch and Black, and keep the article number pattern the same across the family.

### 4. Give variants axes when you want a size grid

A variant can carry axes, such as Size and Colour. When every variant of a parent has the same axes and no two variants share the same values, the deal picker shows a grid of variants with a price for the client, free stock and a quantity field in each cell. Without axes the variants stay a list.

The variant window sets the name, price and unit. The axes are written through the product API, so an implementation partner or a developer sets them once for the whole family.

### 5. Assemble a bundle from components

Open the Kits tab of the item and add components with a quantity each. Choose how the kit goes into a document. Whole means one line with the kit’s own price, and Expand puts the components into the document.

A parent of variants cannot be a component, so pick a specific variant. A kit cannot contain itself, directly or through another kit, and holds up to 100 components. The Available figure of a kit is the number of kits you can assemble, which is the lowest value of stock divided by need across the components.

### 6. Link analogues and retire what is no longer sold

In the Analogs and related tab, list what replaces the item when it is out of stock and what to offer next to it. Retire an item that you stop selling: it disappears from sales, search and the storefront, and stays in the documents already issued.

Krokul offers deleting for good only when the item is not used in any document or deal and is not a parent of variants or a component of a kit. In every other case the item goes to the archive and can come back.

## What does a finished catalog structure look like?

The table shows one distributor’s catalog after the six steps. The numbers are invented for the example.

Example: four catalog items and how each is built:

| Item | Kind | Group path | Structure | Price |
|---|---|---|---|---|
| Laptop bag | Goods | Accessories / Bags | Parent with 12 variants: four sizes × three colours | £22 to £34 by size |
| Manager workstation | Goods | Workstations | Bundle of five components, one of each, sold whole | £1,060 for the kit |
| Installation visit | Service | Field services | Single item, unit is the visit | £140 |
| Antivirus licence | Subscription | Software | Single item, billing period is a year | £18 per seat |

A laptop bag costs £22 in size 13 inch and £34 in size 17 inch, so the price sits on the variant and the parent stays out of documents. The kit price of £1,060 is its own number and is not recalculated when a component price changes, so the manager checks it when the price list moves.

## Which mistakes spoil a product catalog?

- Creating twelve unrelated items for twelve sizes. Create one parent and twelve variants, so that the family is one entry in the list.
- Choosing the wrong kind and fixing it later. The kind never changes, so decide it before the import.
- Putting a parent of variants into a bundle. Pick a specific variant as the component.
- Deleting an item that appears in old documents. Retire it, so that issued quotes and invoices keep their lines.
- Trusting the kit price after a component price changed. The kit price is its own number, so review it after each price update.

## A checklist before you open the catalog to the sales team

- Every item has a kind, a unit, a price and an article number.
- The group tree has two or three levels, and no item sits without a group.
- Families are parents with variants, with the same article pattern.
- Axes are set where a size grid is needed.
- Every kit shows a sensible Available figure.
- Discontinued items are retired and kept in the archive.

## What do you do after the catalog is ready?

Once items exist, three things attach to them. Prices come from price lists and client terms, which the page on [stock and the product catalog in Krokul](https://krokul.com/en/solutions/stock/) describes together with stock levels. Available stock then shows in [the product picker of a quote](https://krokul.com/en/blog/add-items-to-quote-picker/), as the guide on [reserving stock for a quote](https://krokul.com/en/blog/reserve-stock-for-quote/) explains. Reorder points tell you when to buy, as in the guide on setting reorder points.

Stock levels, receiving and reorder lists belong to a higher plan than the catalog itself, and [receiving goods and transferring between warehouses](https://krokul.com/en/blog/stock-receipts-transfers-movements/) shows that side. The catalog, the groups, the variants and the kits can be set up without them.

## Frequently asked questions

### Can I change an item from goods to a service later?

No. Krokul fixes the kind when the item is created, because units, stock and bundles depend on it. Create a new item of the right kind and retire the old one.

### Do variants have their own stock and price?

Yes, each variant is a catalog item with its own article number, price, unit and stock. The parent item is not sold, so documents take the variants.

### How many levels can the group tree have?

Up to five levels. The database refuses a group that would become its own descendant or would go deeper than five levels.

### What happens to items when I delete a group?

The items stay in the catalog and keep the text label of the old group. Deleting a group does not delete items.

### Can a bundle contain another bundle?

A bundle can contain another bundle as a component, as long as the chain has no loop. A bundle that contains itself, directly or through another bundle, is refused.

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs
