Skip to content
LiberoDraft LiberoDraft Help
Deutsch
Start › C Topics › Parts lists

Parts lists

The parts list (BOM, bill of materials) is derived from the block insertions of the drawing: every block definition carries BOM data, the program counts the insertions and lists them with their quantity. You maintain the data once per block; the parts list is always up to date — in the Parts list window, as a live table in the drawing, as CSV and at the item balloons. Each drawing decides for itself which fields exist and which appear as columns (BOM fields).

Dialog «Parts list»: (1) Quantity BOM, (2) Structured BOM, (3) Insert into drawing, (4) Export CSV
Dialog Parts list: (1) Quantity BOM, (2) Structured BOM, (3) Insert into drawing, (4) Export CSV

Step by step: Create a parts list, Place balloons. Commands: Show parts list, Block BOM, Item balloon. Dialogs: Parts list, BOM data.

Opening the parts list

You open the Parts list window with the BOM button in the ribbon, group Annotate (below Leader), with the same button in the classic toolbar to the right of Hatch, with 📋 Parts list (BOM) in the Blocks panel or via the command search (Show BOM). A second click on the button closes the window again. While the block editor is open the parts list is not available; the status bar reports The bill of materials is not available in the block editor — first click «Speichern» (save) or «Abbrechen» (cancel).

When a block insertion is selected, the Properties panel shows its BOM data for reference: the block name, the count n× in the drawing, the filled-in fields and the button BOM data…, which opens the form (Blocks). The data can only be changed in the form.

BOM data per block

Every definition has the standard fields Designation, Article number, Standard, Material, Unit (default Stk), Weight, Supplier, Price and Remark, plus the custom fields of the drawing. When a block is created, the designation is preset with the block name; when a standard part is inserted as block, the values come from the part file (Standard parts). You change the fields in the BOM data form — via the row button ✎ in the Blocks panel, BOM data in the Block manager, right-click on an insertion → BOM data…, the button in the Properties panel or the command Block BOM. The block name can be changed there as well. The values apply to all insertions of this block.

«BOM data» of the block «Screw»: (1) «List as a single part in the BOM», (2) custom field «Surface», (3) «Manage fields…», (4) count in the header
BOM data of the block Screw: (1) List as a single part in the BOM, (2) custom field Surface under Custom fields, (3) Manage fields…, (4) count in the header

The header of the form counts the insertions: n× in the drawing are the top-level insertions in the model and on all sheets; m× in total also counts every occurrence inside other blocks (times their quantity), regardless of as a single part and of hiding. The total only appears when it differs from the count in the drawing. A field of type Number shows its unit next to the input; if the entry is not a number, the note Value is not a number points it out — it is saved anyway.

Blocks without designation and without article number appear grey with the note (no BOM data) and their block name — so they are not missing but flagged as incomplete.

Custom fields and template

Which fields a block carries is set in the BOM fields window — opened via Manage fields… in the BOM data form or via the command search (BOM fields…). The fields belong to the drawing and travel with its file.

«BOM fields» window: (1) check box «In BOM», (2) order ↑/↓, (3) «+ Add field»
BOM fields window: (1) check box In BOM, (2) order ↑/↓, (3) + Add field
  • Adding a custom field: + Add field, enter a label, choose the Type: Text, Number or Choice list (values one per line). A field of type Number also has Unit, Decimals and Totals (see Totals). The standard fields are text; only Weight and Price can be switched to Number (text by default).
  • Renaming: a label can be changed at any time; the internal key stays and the values are not lost. Labels must be unique.
  • Deleting: ✕ at the end of the row. If the field has values in blocks, the program asks first (The field “…” has values in n block(s). Delete the field together with these values?). Standard fields carry a padlock and cannot be deleted. The Used column shows in how many blocks a field has a value.
  • Foreign fields: if inserted blocks, standard parts, block files or a DXF bring BOM entries the drawing does not yet know as a field, the program adds them as fields and reports n BOM field(s) taken over from blocks: …. Entries that exist in blocks but are not yet a field are offered under Found in blocks but not yet a field: with Add as field.

OK applies the changes as one undo step. In the block editor the fields of the drawing cannot be changed (The BOM fields cannot be changed in the block editor — first click «Speichern» (save) or «Abbrechen» (cancel).).

Template for new drawings: Save as template for new drawings remembers the fields of this drawing; every new drawing — including the start drawing — begins with these fields. Apply template adds the template fields the drawing is missing and aligns type, unit and totals of the existing ones. The template can also be edited under Settings → Setup → box Bill of materials → ☰ BOM fields (template)…; there the two buttons are replaced by Take over from drawing and Factory default. Resetting all settings keeps the template. When blocks are copied between drawings their values travel along; type, unit and totals of a field taken over come from your own template, otherwise it becomes a text field.

Which columns appear

The check box In BOM and the arrows ↑/↓ in the BOM fields window decide which fields appear as columns and in which order — in the Parts list window, in the CSV file and in the inserted table. No. and Qty always come first. The choice applies per drawing; the template carries it along. By default Unit, Designation, Article number, Standard, Material, the custom fields and Remark appear; Weight and Price only when they are totalled, Supplier not at all. The BOM data form always shows all fields. For a single inserted parts list, columns can additionally be hidden in the table editor (Hiding columns); the Parts list window, the CSV and newly inserted parts lists keep showing the columns of the column choice.

Totals

A field of type Number can be totalled (column Totals):

  • Qty × value — the parts list gets a column … total next to the field (for example Weight total [kg]) with quantity times value per row, and the row Total adds up this column.
  • Sum of values — the row Total adds the value of each part once, regardless of the quantity (in the structured BOM a part appears under several assemblies and still counts only once).

Calculations use the displayed decimals and round half away from zero. If a number contains both a comma and a point, the last one is the decimal separator (1.250,50 = 1'250.50 = 1250.5). Values that are not numbers are skipped; the total row names them (n value(s) not a number). The total row appears in the window, in the CSV and in the inserted table; quantity and structured BOM give the same total.

Quantity and structured BOM

The quantity BOM merges identical parts and sorts them by designation; the item number is the row number. The structured BOM shows the assemblies as a tree with item numbers 1, 1.1, 1.2 … and total quantities across the levels (3 assemblies with 2 washers each = 6 washers). Both views are switched at the top of the window. The window grows with the number of columns. The parts list always refers to the model — even when you open it from the paper space.

Structured BOM: the assembly «Flange set» is dissolved and shows its parts as items 1.1 and 1.2; at the bottom the «Total» row
Structured BOM: the assembly Flange set is dissolved and shows its parts as items 1.1 and 1.2; at the bottom the Total row

As a single part and dissolved assemblies

The check box List as a single part in the BOM in the BOM data (default: on) decides how an assembly counts. On: the assembly is one item, its sub-blocks are not counted — right for a purchased part drawn from several blocks. Off: the assembly is dissolved, the contained blocks count; the quantity multiplies across the levels. The Block manager shows the mark 1 part or dissolved accordingly. If the structured BOM has no sub-levels, a note under the table explains that every block counts as one part and which check box dissolves an assembly.

Article number as key

Blocks with the same article number are merged into one item of the quantity BOM, even if they are different definitions (for example a side view and a top view of the same purchased part). Without an article number every definition is its own item. A variant automatically receives the article number suffix -2, so that it counts separately. If two definitions carry the same article number with different values, the total uses the value of the one counted first.

Hidden blocks and layers

If definitions are hidden via the eye or insertions lie on hidden layers, the program asks once each time the Parts list window is opened: The drawing contains n hidden block(s). Should they be INCLUDED in the parts list? OK = include · Cancel = leave out (for layers: … n insertion(s) on hidden layers …, for both one combined question). Insertions on hidden layers count like hidden blocks. The answer applies to the quantity and structured BOM, inserting and CSV export, and is remembered for the drawing until you are asked again; another drawing starts without an answer.

The item balloons never ask: they follow the governing live parts list, if there is none the last answer given, otherwise they count everything. A live parts list remembers the answer that applied when it was inserted.

Live parts list in the drawing

Insert into drawing creates a block Parts list from the current view (quantity or structured BOM) and attaches it to the mouse (Parts list as block “…” — click to place). This table is live: it follows the drawing — quantities, parts, values, column choice and language —, has the columns from the column choice (without the rows and columns hidden in the table editor) and a total row when a field is totalled. A line break in a value becomes « / » in the cell. The table block itself is not counted (mark Parts list in the Block manager, BOM table (not counted) in the Properties panel).

Inserted live parts list in the drawing, with total row
Inserted live parts list in the drawing, with total row
  • Copies of the same table in the drawing (Ctrl+C/Ctrl+V) share the definition and show the same content. An independent second table is created with Insert into drawing.
  • Manual changes to cells, rows, columns and the alignment are made in the table editor. Edit block, BOM data… and Split off as variant are missing from the context menu of a live parts list; other routes (Block manager, Blocks panel, command search) report in red Live parts list — it is generated from the drawing and cannot be edited in the block editor; cells via «Edit parts list…» (double-click), for a fixed version use «Explode».
  • Fixed version: Explode breaks the table into lines and texts that no longer follow the drawing.
  • If the table lies on a locked layer or in a locked group, it cannot be edited (Parts list locked (layer or group) — unlock it first).

Parts lists from older versions

A parts list inserted with LiberoDraft up to 4.0.0 is a snapshot and does not follow the drawing. Right-click on it → 🔄 Replace with live parts list rebuilds it from the drawing. The program asks first, because contents changed by hand are lost (The parts list «…» will be rebuilt from the drawing and will then follow it. Contents changed by hand will be lost (Ctrl+Z undoes this). Replace?), then follows the question about hidden parts. The replaced parts list becomes live and governing; Ctrl+Z undoes the replacement. An old parts list is recognised by its form (lines and texts with the header Pos. and Menge or No. and Qty).

Governing parts list

If the drawing contains one or more live parts lists, exactly one of them is governing: the item balloons follow it — quantity or structured item numbers, overridden item numbers and its answer to the question about hidden parts.

Right-click on a live parts list: (1) «Edit parts list…», (2) «Position balloons follow this parts list» with a check mark
Right-click on a live parts list: (1) Edit parts list…, (2) Position balloons follow this parts list — the check mark is on the governing one
  • The parts list inserted last automatically becomes governing — also one that arrives via Ctrl+V from another drawing, with a standard part or from an add-on tool. If one insertion brings several, the one chosen in the source becomes governing.
  • To choose: right-click on a parts list → 📍 Position balloons follow this parts list (one undo step). The governing one shows ✓ Position balloons follow this parts list.
  • For a selected parts list the Properties panel shows whether the balloons follow it (✓ Position balloons follow this parts list or Position balloons follow another parts list (right-click to choose)).
  • If the governing parts list is deleted, the one chosen last (by right-click or insertion) takes over, otherwise the one inserted last that still exists. A hidden parts list stays governing.
  • Without a live parts list the balloons count according to the quantity BOM and the last answer given.

Table editor

A double-click on a live parts list or right-click → 📋 Edit parts list… opens the Edit parts list window. Here you override and add to cells without changing the block data: Select a cell and type — the original stays in the block data. The overrides belong to the table (its definition) — all copies in the drawing show the same. The window can be moved and resized (Window, column width and sorting); rows and columns can be hidden (rows, columns).

«Edit parts list» window: (1) overridden cell, (2) overridden item number, (3) free row, (4) override without a row with «Assign…» and «Delete», (5) OK
Edit parts list window: (1) overridden cell, (2) overridden item number — the row then stands at its new place, (3) free row, (4) override without a row with Assign… and Delete, (5) OK

Overriding cells

  • Operation: click a cell or select it with the arrow keys, then type (replaces the content) or double-click, Enter or F2 (edits the content); Enter or Tab completes the entry. Del restores the original, right-click opens the cell menu, Ctrl+Z/Ctrl+Y undo and redo inside the editor. AltGr characters (@, #, € …) can be typed as well.
  • Marking — only in the editor: an overridden cell has a blue background, a bar on the left and a ✎; the tooltip names the original (Overridden · original: …, for a previously empty cell Added · original: empty). If the original has changed in the block data since, the cell is orange (Overridden: … · original when overridden: … · today: …). The … total column and the total row calculate with the displayed values. In the drawing and in print the table looks neutral.
  • The header counts items, free rows, hidden rows and columns, overrides and overrides that are not shown (header counters).
Cell menu of the table editor with «↺ Restore original (Del)», «↺ Whole row back to original», «↺ All cells back to original», «⇢ Take value over into block data», «+ Free row», «✕ Delete free row», «Hide row (Ctrl+E)», «Show all rows» and «🔢 Renumber»
Cell menu (right-click on a cell): ↺ Restore original (Del), ↺ Whole row back to original, ↺ All cells back to original, ⇢ Take value over into block data, + Free row, ✕ Delete free row, Hide row (Ctrl+E), Show all rows, 🔢 Renumber

Overriding item numbers

The No. column can be overridden as well. The table is ordered by item number, in natural order (1, 2, 2a, 10), empty numbers last; the structured BOM orders per assembly. After Enter the row moves to its new place; the row that was below it becomes active. Sub-items follow the overridden number of their assembly (5 → 5.1, 5.2) unless they are overridden themselves. Duplicate numbers are allowed but marked red with «‼» (Item no. occurs more than once); «1» and «01» count as equal. The item balloons show the overridden numbers of the governing parts list; the numbers of another parts list only apply in its own table.

Free rows

+ Free row (button at the top or cell menu) adds a row without a part — for example for adhesive or small parts that are not drawn (Free row added — no part and no balloon). It has a green background, is sorted by its item number and counts in the total row; it has no balloon and does not appear in the Parts list window or in the CSV. It is removed with ✕ Delete free row.

Hiding rows (eye)

The column at the far right carries an eye for each row; it stays at the right edge when you scroll sideways. A click on the eye or Ctrl + E (row of the selected cell) hides the row or shows it again (Row hidden — missing from the table, the total and the balloons). In the editor the row remains, struck through and with a closed eye; after OK it is missing from the drawn table and its total, and its item balloon stays empty if this parts list is the governing one — the other balloons keep their numbers. A click on the eye in the column header shows all rows again; the cell menu offers Hide row or Show row and Show all rows for this. Free rows can be hidden in the same way. In the structured BOM the sub-items of a hidden assembly remain. A hidden row does not count as a duplicate item number; its overrides are kept and apply again when it is shown. The Parts list window and the CSV still show all parts.

“Edit parts list” window with a hidden row: (1) eye of the row, (2) eye in the column header, (3) counter in the header line, (4) Renumber
Hidden row in the Edit parts list window: (1) closed eye — the row is struck through, (2) eye in the column header — show all rows, (3) counter in the header line, (4) 🔢 Renumber

Renumbering

🔢 Renumber (button at the top or cell menu) gives the visible parts consecutive numbers 1, 2, 3 … — in the structured BOM 1.1, 1.2 … per assembly —, in the order of the table by item number and regardless of any sorting in the window. Hidden and free rows keep their numbers. The new numbers go into the No. column like numbers overridden by hand; the balloons follow them after OK (n item(s) renumbered; if there is nothing to do: The items are already numbered consecutively). Ctrl + Z in the editor undoes it.

Hiding columns

Right-click on a column header → Hide column removes the column from this parts list (Column «…» hidden — omitted from the table in the drawing). Show/hide columns… opens a list of all columns with check marks: a click hides or shows a column, and the list stays open; Show all columns brings all of them back, Esc closes only the list. No. cannot be hidden (grey in the menu and in the list). The header line states n column(s) hidden.

“Show/hide columns” list: (1) No. greyed out, (2) hidden column without a tick, (3) Show all columns
Show/hide columns… list: (1) No. — cannot be hidden, (2) hidden column (no tick), (3) Show all columns
  • The column is missing in the editor and, after OK, in the drawn table including the total row; if no visible column has a total any more, the total row disappears completely.
  • Arrow keys, Tab, End and pasting from the clipboard skip hidden columns. If the list is sorted by a column you hide, the order by No. applies until it is shown again. ↺ Whole row back to original and ↺ All cells back to original only affect visible columns.
  • Overrides in a hidden column are kept (header line n more not shown) and apply again as soon as the column is shown.
  • Hiding applies only to this parts list. The Parts list window, the CSV and newly inserted parts lists show all columns of the column choice; for all parts lists of the drawing at once, use the check box In BOM in the BOM fields window. A field that is switched off and on again there stays hidden in a parts list in which it is hidden.

Column alignment

Right-click on a column header → Alignment: left, Alignment: centered, Alignment: right or Alignment: automatic (numbers right, text left; default); a ✓ marks the current choice. The alignment applies to the header, the cells and the total row — in the editor and, after OK, in the drawn table as well. It belongs to this parts list: Ctrl + Z in the editor, Cancel and, after OK, Ctrl + Z in the drawing undo it.

Right-click on a column header: (1) Hide column, (2) Show/hide columns…, (3) chosen alignment with a tick, (4) Reset view
Right-click on a column header: (1) Hide column, (2) Show/hide columns…, (3) chosen alignment with ✓, (4) ↺ Reset view

Window, column width and sorting

  • Window: drag the title bar to move it, drag the grip in the lower right corner to resize it (Resize window, at least 520 × 260 pixels); the ✕ at the top right closes like Esc (Close without applying (Esc)).
  • Column width: drag the right edge of a column header; a double-click on the edge or ↺ Reset column width (right-click on the header) restores the standard width derived from header and content. A truncated value appears in full in the tooltip of the cell.
  • Sorting: a click on a column header sorts ascending, a second click descending, a third removes the sorting (order by No.); an arrow in the header shows the direction. Since the list is already ordered by No. ascending without sorting, a click on No. switches straight to descending. Number columns sort by value, No. naturally (1, 2, 2a, 10); empty values always come last. Sorting applies only in the window — the drawn table keeps the order by No. regardless. Only the order by No. shows the tree of a structured BOM; sorted, it appears as a flat list.
  • Remembered are the position and size of the window, the column widths and the sorting — in the browser, not in the drawing; they apply to every parts list you edit. ↺ Reset view (right-click on a column header) restores the defaults (View reset). 🔄 Factory defaults in the settings deletes the remembered view as well, 📤 Export (JSON) takes it along (Manage settings).

Copying to the clipboard

📋 To clipboard copies the parts list as it appears in the window: the column headers, the visible rows in the displayed order (including free rows) and the total row, tab-separated — for pasting into Excel or LibreOffice Calc (Parts list copied — n row(s) on the clipboard). Hidden rows and columns are left out; a line break in a value becomes « / ». If the browser does not allow access to the clipboard, the window reports Copying to the clipboard is not possible. The other way round, Ctrl + V pastes text with tabs (from Excel, for example) into the visible columns, starting at the selected cell.

Overrides without a row

If a part disappears from the drawing, its overrides are kept. The editor lists them below the table: Overrides without a row — the part is not (or no longer) in the parts list:. Assign… attaches them to another row, Delete removes them. If the part comes back, they apply again. Overrides in columns the parts list does not show at the moment (column choice or hidden) are kept as well; the header line counts them as n more not shown.

Taking a value over into the block data

⇢ Take value over into block data marks an overridden cell: on OK its value is written into the BOM data of the block and then applies everywhere (Taken over into the block data on «OK»; withdraw with ↺ Withdraw take-over into block data). If the same block stands in several rows, it can only be taken over with one value; an empty value is refused if the parts list would then show a default. Free rows have no block data.

OK, Cancel, Escape

OK writes all changes — including hidden rows and columns and the alignment — as one undo step (Parts list «…» edited — n cell(s) overridden, where applicable followed by · n row(s) hidden · n column(s) hidden); overrides equal to the original are dropped. On a sheet the step goes to the model history — restore it via the Model tab, then Ctrl+Z. Cancel discards without asking; Escape and the ✕ at the top right ask if something has changed (Discard the changes to the parts list?). If a menu or the column list is open, Esc first closes only that.

CSV export

Export CSV writes the file stueckliste.csv (semicolon-separated, UTF-8 with marker for Excel). Without a column choice of your own it has the columns Pos, Menge, Einheit, Bezeichnung, Artikelnummer, Norm, Material, Gewicht, Lieferant, Preis and Bemerkung — for blocks without data the remark says no BOM data; custom fields come before the remark. Once you have made a column choice in the BOM fields window, the CSV follows it; the header is then in the program language. Totalled fields bring their … total column and the Total row. The structured view exports with the tiered item numbers. Overrides and free rows of the table editor belong to the inserted table and are not in the CSV; rows and columns hidden there are not hidden in the CSV. If the export fails, no file is created and the status bar reports the error in red.

Item balloons

An item balloon Balloon is a circle with a pointer that is attached to a block insertion and shows the item number from the parts list. The number is live: it follows the parts list with every change, including a renaming. If there is a live parts list, the balloons follow the governing one — quantity or structured item numbers and their overridden numbers (so you change a number in the table editor, not at the balloon; a row hidden there leaves its balloon empty); otherwise they show the items of the quantity BOM. If the balloon shows ?, the block is not an item of its own — for example a dissolved assembly; the balloon then reaches through the assembly to the individual part, or it is attached to an excluded block.

(1) and (2) balloons on block instances with items 1 and 2; (3) free balloon with its own text at the base plate
(1) and (2) balloons on block instances with items 1 and 2; (3) free balloon with its own text at the base plate

A balloon on any element or in empty space is a free balloon: it first shows ?; double-click opens Balloon text for a text of your own. Balloons belong to the dimension family: they lie on the system layer Dimensions, take text height and arrow size from the dimension settings, move with the bound element and can be placed in viewports of the paper space.

Print, DXF

The inserted table and the balloons are printed like geometry — without the coloured markings of the table editor. In DXF, balloons are exploded (circle, pointer, text), the table goes like any block (Blocks in DXF); older LiberoDraft versions see a live parts list as an ordinary block. The parts list itself reaches other programs via the CSV file.

Related topics