How does kit and bundle inventory work in Luminous — how do I set up a bill of materials, and how is kit stock displayed on the Stocks page?

Two ways to group products in Luminous

Luminous offers two distinct approaches to bundled or assembled products, and understanding the difference is important before you set anything up:

Approach	Best for	Holds its own stock?	Appears in Inventory Valuation?
Kit SKU	Selling a group of existing components together without pre-building anything	No — stock is calculated from components	No
BOM + Assembly Order	Physically manufacturing or pre-kitting a finished product you store on the shelf	Yes — the finished-good SKU holds its own inventory	Yes

Kit SKUs (virtual bundles)

What a kit is

A Kit (sometimes called a bundle in ecommerce platforms) is a virtual product type in Luminous. It groups two or more existing component SKUs and sells them as a single unit. Kits carry no inventory of their own — Luminous derives the kit's available quantity entirely from its components every time stock is recalculated.

How availability is calculated:

For each component, Luminous computes:

Component available = On Hand − Pending (quantity reserved by open orders)

That result is divided by the number of units of that component required per kit (rounded down to a whole number). The lowest result across all components becomes the kit's available quantity — the bottleneck component wins.

Example:

Component	On Hand	Pending	Available	Required per Kit	Kits Possible
Widget A	20	2	18	2	9
Widget B	10	1	9	1	9
Widget C	5	0	5	1	5

Widget C is the bottleneck → the kit shows 5 available.

Creating a Kit SKU

Go to Inventory → SKUs and click Create.
Under Product Type, select Kit.
Enter the Name and SKU code.
On the Kit Items tab, add each component SKU and set the quantity required per kit.
Click Save.

⚠️ The Product Type cannot be changed after you save a SKU. If you need a different type, create a new SKU from scratch.

To bulk-import kits, go to Tools → Imports → Product Catalog, set the Type column to Kit, then upload a second file to attach the components. All component SKUs must already exist before the import.

Managing kit inventory

You cannot add or adjust inventory directly on a kit SKU. The Add Adjustment button and the Qty Logs / Costs tabs are intentionally hidden on kit product pages.
To increase a kit's available count, receive inventory or create adjustments on the component SKUs.
When a kit order is fulfilled, Luminous automatically deducts the required quantity from each component — the kit SKU itself is never touched.

Expanding kits for fulfillment

By default, a fulfillment order sent to your warehouse lists the kit as a single line item. If your warehouse needs to pick each component separately, enable Expand Kits for Fulfillment on the sales channel (Manage → Channels → [your channel]). When this is on, the fulfillment order breaks the kit into one line per component. The original sales order still shows the kit SKU, and inventory is always deducted from components regardless of this setting.

Bills of Materials (BOMs) and Assembly Orders

If you physically build or pre-assemble a product before storing it, use a Bill of Materials paired with an Assembly Order instead of the Kit feature.

What a BOM is

A BOM is a named recipe — a list of component SKUs with their quantities and units of measure — required to produce one unit of a finished product. Once components are consumed through an assembly order, the finished-good SKU gains its own inventory and cost layer.

Setting up a BOM

Go to Inventory Admin → Bills of Materials.
Click Create BOM.
Add each component row: search for the component SKU, set the quantity and unit of measure, and add any notes.
Click Save.

Every component must already exist as a SKU in Luminous before it can be added to a BOM.

To bulk-import BOM lines, go to Tools → Imports → Bill of Materials, download the Excel template, fill in Product SKU, Component SKU, Quantity, and optional fields, then upload.

Attaching a BOM to a finished-goods SKU

Open the product page for your finished-goods SKU.
On the Details view, click the edit (pencil) icon next to the Bill of Materials section.
Search for and select the BOM, then click Done.

You can attach more than one BOM to a single SKU (for example, when the same product can be made from alternative component sourcing). When you create an assembly order, you choose which BOM to use for that run.

Creating an Assembly Order

Go to Inventory → Assembly Orders and click Create.
Select the finished-goods SKU and choose the BOM to use.
Set the Destination (warehouse group, warehouse, or bin location).
Enter the quantity to produce.
If lot tracking is enabled, assign or create a lot number for the finished product.
Save the order and advance it through the workflow:

Status	What happens
Draft	Created; no inventory reserved yet
Issued / In Progress / Paused	Component quantities moved to pending (reserved)
Completed	Components fully deducted; finished-goods stock increased

Luminous also supports Disassembly Orders — the reverse operation — which breaks a finished product back into its components.

How kit stock is displayed on the Stocks page

Go to Inventory → Stocks to see all SKU stock levels. Kit SKUs appear in the same table as regular products, with a few differences.

Filtering to kit SKUs

Use the Product Type dropdown in the toolbar and select KIT to show only kit rows (or choose PRODUCT to hide kits and see only regular inventory items).

What the columns show for a kit

Column	What it shows for a Kit
Incoming	Minimum whole kits buildable from each component's in-transit / on-order quantity
Onhand	Minimum whole kits buildable from each component's on-hand stock
Pending	Quantity reserved by open orders against the kit
Available	Onhand minus Pending (the bottleneck-component result)
FIFO Cost	Not applicable — kits carry no cost layers of their own

One visual difference: for regular products, the Incoming number is a clickable link that opens a drill-down into the related purchase orders. For kit rows, the Incoming number is displayed as plain text only, because incoming stock belongs to the component SKUs — not the kit itself.

Exporting kit stock numbers

In the Stocks toolbar, click the Export SKUs dropdown. You will see two separate options:

Export Inventory Numbers to CSV — exports regular (non-kit) SKU quantities
Export Inventory Kit Numbers to CSV — exports kit SKU quantities

Key things to remember

Kits are virtual. They never appear in the Inventory Valuation report; only the component SKUs do.
BOMs produce real inventory. Finished goods created through an assembly order hold their own stock and cost, and do appear in valuation.
To raise a kit's available count, always adjust the component SKUs, never the kit SKU itself.
The Product Type is locked once a SKU is saved — create with the correct type from the start.