Skip to content

Bill of Materials

A Bill of Materials (BOM) defines what a SKU is made of — a list of component lines, each either a raw component SKU or another BOM (a sub-assembly), letting you model multi-level products.


Accessing the BOM list

Open the Planning sidebar and select BOM.


The BOM list

Each row is one BOM (a SKU at a specific version) and shows the SKU, version, status, and number of component lines. Click a SKU to open its BOM detail page.

Status values

Status Meaning
Draft Still being worked on
Released Finalised and ready to be referenced by Manufacturing Orders

Creating a BOM

Click New BOM and provide:

Field Description
SKU ID Required — the product this BOM describes
Version Defaults to 1

New BOMs are always created in Draft status.


Adding components

Open a BOM and click Add Line. Choose a Component Type:

  • Raw component (SKU) — specify a Component SKU ID directly.
  • Sub-assembly (another BOM) — pick an existing BOM from the dropdown. The current BOM is excluded from the list to prevent it referencing itself.

Then fill in:

Field Description
Quantity Required — how many units of this component are needed
UOM Optional unit of measure (e.g. ea, litre)
Scrap % Defaults to 0 — expected wastage for this component

Each line shows its position, component (name, or a link to the sub-assembly's own BOM for drill-down), type badge (SKU or Sub-assembly), quantity with UOM, and scrap percentage. Use the row's Delete action to remove a line.

Tip

Clicking a sub-assembly component takes you to that BOM's own detail page — you can drill down through as many nested levels as your product structure needs.


Variant Condition

If your organisation uses variant attributes on Manufacturing Order items (e.g. voltage class, cooling type), a catalog BOM can have a Variant Condition — a rule describing which variant values this BOM is meant for. On the BOM's detail page, click Edit next to Variant Condition and enter a condition such as:

{"field":"Voltage Class","op":"==","value":"11kV"}

When an order item's own variant values match the condition, this BOM is pre-selected (marked Suggested) in that item's BOM picker on the Manufacturing Order's detail page — a starting point, not a requirement; any BOM can still be picked manually. Leave the condition empty to have this BOM always appear as a manual pick, never auto-suggested.


Attachments

The BOM as a whole has its own Attachments section, and each component line has a paperclip icon for attaching files to that specific line — see Attachments for how to use it.