Altium NEXUS Documentation

Working with a Bill of Materials Object on a Draftsman Document in Altium NEXUS

Created: June 15, 2017 | Updated: July 14, 2021
All Contents

Parent page: Draftsman Objects

A Bill Of Materials table split over two BOM objects. In the above example, the BOM content is filtered to include the items from the Top side Board Assembly View.


A Draftsman Bill Of Materials (BOM) is an automatically generated table object that lists the physical assembly items in a PCB design. The table data is directly derived from the project PCB file or if one is present in the current project, an Active BOM document. A Draftsman BOM Table can also represent the constituent items from a specified design Variation or a placed Board Assemby View.

The BOM table's visual style and included data content is configurable in (or via) the Properties panel. 


A Bill Of Materials table is available for placement in a PCB project Draftsman document from the Editor as follows:

  • Choose the Place » Bill Of Materials command from the main menus.
  • Click the  button in the table objects drop down menu on the Active Bar located at the top of the workspace. Click and hold an Active Bar button to access other related commands. Once a command has been used, it will become the topmost item on that section of the Active Bar.
  • Right-click in the drawing workspace then select Place » Bill Of Materials from the context menu.
  • Click the Bill Of Materials () entry in the tables drop-down menu () on the Drawing Annotations toolbar (View » Toolbars » Drawing Annotations to enable).


After launching the command, BOM data is retrieved from the source PCB file or Active BOM document, the cursor will change to a cross-hair and the generated BOM table is attached to the cursor. Move the cursor to the desired position then click to confirm the placement.

Note that BOM data is retrieved from the PCB document specified in the Source section of the Properties panel when in Document Options mode. To change the panel to that mode, deselect all objects in the workspace (click in free space).

Graphical Editing

The position of a placed Bill Of Materials may be graphically changed by selecting the table in the workspace then dragging it to a new location. Note that the table cannot be graphically resized, but will automatically scale to accommodate the font style/size as specified in the Properties panel.

To help manage the vertical size of a BOM table in a Draftsman document, the listing sequence can be split over a number of table objects – see Split BOM Tables.

The default settings for the Bill Of Materials are available in the Draftsman - Defaults page of the Preferences dialog.

Non-Graphical Editing

Properties page: Bill Of Materials Properties

The non-graphical method of editing a Bill Of Materials table is available in the Draftsman Properties panel, which provides a range of editable properties, style and design content settings for placed Draftsman objects.

The Properties panel when a Bill Of Materials table is selected.

To open the Properties panel and access the properties of a placed Bill Of Materials table:

  • Double-click on the Bill Of Materials table object in the workspace.
  • Right-click on the Bill Of Materials then select Item Properties from the context menu.

If the Properties panel is already active:

  • Click on the Bill Of Materials table to access its properties in the panel.
To manually open the Properties panel, select View » Panels » Properties from the main menus or click the button at the bottom right of the workspace then select Properties from the pop-up menu.
Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.



We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: