Insert BOM table icon on toolbar

Insert a Bill of Materials table from an Onshape BOM table, uploaded file, or an authorized app. You are also able to use the Balloon tool to automatically pull identifiers from the BOM to label the drawing. See Balloon for more information.


  1. Click Insert BOM tool icon.
  2. Select to insert a Bill of Materials from the currently active document, or another document.

    Inserting a BOM table

    If there are Onshape BOM tables in your document, they are automatically listed in the drop down menu (shown with Master assembly above); select one, then the parameters:

    1. If you are part of a company or enterprise and your administrator has added BOM table templates, you can select one from the Template dropdown.
    2. The BOM type: Flattened (no assembly hierarchy indicated), Structured - Top level (assembly hierarchy indicated for one level only), or Structured - Multi-level (all levels of assembly hierarchy indicated).
    3. Order: Top to Bottom or Bottom to Top

    The three types of BOMs are shown below: Flattened, Structured-Top level, and Structured-Multi-level, respectively:

    Flattened BOM

    Structured, top-level BOM

    Structured, multi-level BOM

    In the multi-level BOM, immediately above, the sub-assembly (Assembly A) is listed as item number 1 and it consists of two parts, listed as item numbers 1.1 and 1.2 (Parts 2 and 3). Sub-assembly (Assembly B) is listed as item number 2 and it consists of two parts, listed as item numbers 2.1 and 2.2 (Parts 1 and 3). The top-level BOM, the middle BOM above, lists only the top-level of the two sub-assemblies. The flattened BOM, the first BOM above, lists just the parts contained in the Assembly.

    Use the Insert icon Insert Part or Assembly Icon to select a BOM file or table from an approved app.

    example of using the Insert icon to select a BOM file or table from an approved app

    From here you can use the standard Insert dialog to select from the current document, another document, create a version to work with or select another version of a document. You can insert BOMs from versions, workspaces, and releases that don't have a BOM, as well. You can also select from Assemblies in the current document, use BOM data that you have uploaded in the form of a file, or select a BOM from an approved app you are using.

  3. Select whether to insert Bill of Materials data from:
    • The current document or Other documents
      • Assemblies - Within whatever filter you have selected: Current document or another document. The setting of the Assembly property, Subassembly BOM behavior, controls how the assembly appears in the drawing bill of material.
      • BOM data - An uploaded file containing data, select the file or use the Import option at the bottom of the dialog to upload a file (not shown above) .
      • BOM app - Data created from a BOM app through the Onshape App store, select the Bill of Material.
  4. If a document contains released parts, the Release filter is present; use this filter Release canidate icon to display only data that has been released.
  5. Select which corner of the table to set as your fixed corner at the bottom of the dialog (as shown below).

    Select fixed corner section of drawings table

  6. The default anchor point in Onshape is the upper right corner of tables.

    There is no need to click directly on the point once it is visible. While moving the mouse to place the Bill of Materials, you'll notice thin, dashed lines as the cursor passes near other entities. These are inferencing lines that you are able to align the BOM to; simply click when you see the line appear to align the BOM to that line.

  7. Click in the drawing space to place the Bill of Material table.