Altium NEXUS Documentation


Created: June 26, 2017 | Updated: January 18, 2019
Now reading version 2.1. For the latest, read: InsertBillOfMaterials for version 5
Applies to altium-nexus versions: 1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 3.2, 4 and 5
This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer (with Altium Designer Enterprise Subscription) and a connected Altium 365 Workspace. Check out the FAQs page for more information.

Parent page: PcbDrawing Commands

The following pre-packaged resource, derived from this base command, is available:

Applied Parameters: None


This command is used to place a Bill of Materials table object into the active Draftsman document (*.PCBDwf). Presenting tabular data that is directly derived from the project PCB files, a Bill of Materials table provides a simple, visual way to convey crucial information for the PCB assembly process.

For a high-level look at how the Altium Draftsman Drawing System provides an interactive approach to the creation of production documentation for your PCBs, see Draftsman. For detailed information about this object type, see Bill of Materials.


This command can be accessed from the PcbDrawing Editor by:

  • Choosing the Place » Bill Of Materials command from the main menus.
  • Locating and using the Bill of Materials command () on the Active Bar.
If the command has been recently used from the Active Bar, it will become the active/visible button. Where other commands are available, this is indicated by a triangle at the bottom-right corner of the button. Click and hold on the active button to access a menu of all associated commands for that grouping.
  • Clicking the  entry on the Tables drop-down () of the Drawing Annotations toolbar.
  • Right-clicking in the workspace and choosing the Place » Bill Of Materials command from the context menu.


If your PCB design project has more than one PCB, ensure that the board from which you wish to generate the BOM table is selected in the PCB Document field in the Source section of the Properties panel (set to present the Document Options when no objects are selected in the workspace).

After launching the command, data will be acquired from the source PCB document, and a Bill of Materials table will appear floating on the cursor. Position the table as desired and click to effect placement. If your Draftsman document has multiple sheets, you can zoom out and move the table to the intended sheet, while it is still floating on the cursor.


  1. A Bill of Materials table can be graphically modified after placement. Click and drag the table to move it to a different location within the current sheet.
  2. Most aspects of a placed Bill of Materials table are available for editing through the Properties panel. If the panel is already open, select a placed Bill of Materials table to populate the panel with its associated properties. If the panel is not open, double-click on the Bill of Materials table to access it.
  3. The Data Filtering options in the Properties panel allow the BOM content to reflect a selected board design variant and/or filter the content to that of any Board Assembly View that has been placed within the Draftsman document (the default is All content and All Variants).
  4. Setup the BOM table's available content and data grouping in the Bill Of Materials Configurations dialog. Access to this dialog is made by clicking the BOM Item button, at the bottom of the Properties section within the Properties panel, when browsing/modifying the properties of the selected Bill of Materials table. Of particular note is the Data Source property. This defines which PCB project data files are used to derive the BOM item list - by default, this the current Board design. The alternative Project option will extract BOM data from all design files in the nominated PCB project. The latter brings in all project data, including custom component parameters from the project schematic document(s).
  5. If changes have been made to the PCB document, using the Tools » Update Board command will ensure that a placed Bill of Materials table is kept in-sync.
  6. A BOM Table can be split over several pages, if required. Select a placed BOM (which is likely to exceed the document sheet height) and check the Limit Page Height box in the Properties panel’s Pages section. This will restrict the height of the BOM table to the nominated height entry (Max Page Height, mm), and therefore the number of lines shown in the table. Draftsman detects that the entire BOM is not shown, as indicated by the panel's Page entry (for example, 1 from 2), and the associated drop down menu allows you to nominate which page is shown. To add further pages of the BOM, place another BOM table and specify the next page under Page in the Pages section of the Properties panel. Since each page of the BOM is placed by adding another BOM table, and then configuring it accordingly, the individual BOM pages (sections) can be placed on any sheet in a Draftsman document. To place another, different set of split BOM pages, specify an alternative BOM Table ID on a placed BOM – say, 1 rather than 0.
  7. Defaults for this primitive type can be defined on the Draftsman - Defaults page of the Preferences dialog.


Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

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: