Tutorial 13 · Release
BOMs & Exports
6 min read · Includes video
What you'll learn
- How to open and filter the Bill of Materials (BOM) and export it to CSV — from the diagram or harness editor
- How to use the Connections Table for pin-to-pin documentation
- How to generate a harness Cut List for manufacturing
- How to export a diagram or harness drawing as PDF, PNG, or JPEG
- How to do bulk exports across an entire project
Prerequisites
- Complete Tutorial 5: Make your First Diagram so you have devices, connectors, and wires that produce BOM rows.
- Complete Tutorial 10: Make your first Harness with routed segment lengths and cut-length formulas so wire/cable lengths are accurate in the BOM.
Steps
1Open the Bill of Materials
All export actions live in the right Properties pane when nothing specific is selected on the canvas.
Diagram editor: click empty canvas (or deselect everything). The Diagram Properties view appears.
Harness editor: the same gesture opens Harness Properties (see Tutorial 10: Harness Editor). BOM is harness-scoped — treatments and segment contents roll up here.
- Click BOM (DocumentCurrencyDollarIcon).
The Bill of Materials modal opens. It has tabs at the top:
- All — every part on the diagram
- Devices
- Connectors
- Cables
- Tools
A checkbox lets you Hide unused devices / connectors so the BOM only counts what is actually wired.
2Export the BOM to CSV
The bottom-right of the BOM modal has the export controls.
- Click the gear icon next to Export CSV (tooltip CSV filename options) to control filename composition. You can include the Diagram name, Harness name (in the harness editor), and Version name in the filename.
- Click Export CSV to download.
Lengths and masses show in your Project Units (project menu → Project Units; see Tutorial 17: Admin Options). The same units apply to the Connections Table, Cut List, and drawing exports below.
Default filename suffixes per tab are bom, device_bom, connector_bom, cable_bom, and tool_bom.
Double-click any BOM row to select that item on the canvas and close the modal — useful for jumping straight to a part you have a question about.
3Open the Connections Table
A Connections Table is the pin-to-pin manufacturing document. It lists every connection (or every pin if you choose) with its harness, cable, end devices and pins, and length.
- Diagram Properties or Harness Properties → click Table (TableCellsIcon).
- The Connections Table modal opens. In the harness editor, the table is limited to that harness's wires.
- Optionally enable Show Unconnected Pins to include floating pins.
Columns include Harness, Cable ID, Device A, Device B, pin fields, Routed Length, Cut Length, Gauge, and more. Clickable cells jump to the corresponding diagram item.
Right-click a row for Swap A/B Columns, which is handy when your shop standard expects a particular end-A / end-B convention.
4Export the Connections Table
Click Export CSV at the bottom of the Connections Table modal. The default filename suffix is connections_table. The same filename options gear is available next to the button.
5Generate a harness Cut List
The Cut List is harness-scoped and shows the actual lengths your shop needs to cut. It is only available from the harness editor — there is no diagram-level Cut List button.
- Open the harness editor for the harness you want to manufacture (see Tutorial 10: Harness Editor).
- In Harness Properties, click Cuts (Scissors icon). You can also open the same list from Build Config → Cut List (Tutorial 10: Harness Editor, Step 9).
- The Cut List modal opens.
Columns: Part Name, Cut Length, Qty, References, Total BOM Length. The footer shows a count summary (e.g. 3 cuts · 2 part names). Click any row to highlight the corresponding wires/segments on the canvas and close the modal.
If the modal shows the empty state "No cuts to make — add wires with a defined length to populate this list.", go back to the harness editor and set Routed Length on segments first.
Click Export CSV to download the list. Cut length calculations come from the Build Config tab in the harness editor's left pane — that's where tolerance and cut-length formulas live.
6Export the diagram as PDF, PNG, or JPEG
For a polished hand-off you usually want a rendered drawing, not just CSVs. This works from both editors:
- Diagram editor: Diagram Properties → Export Diagram at the bottom.
- Harness editor: Harness Properties → Export Diagram at the bottom — exports the harness drawing instead of the schematic.
- The Export Settings: modal opens.
- Pick a Format: — PDF, PNG, or JPEG.
- Choose Pages: — All or Custom (e.g.
1-5; 1,2,5). - For PDF, optionally tick Additional Exports:
- Pin Tables
- Connection Tables
- BOMs (with a Combined sub-checkbox)
- Diagram Comments (title-block field)
- Comment Threads (review threads)
- Click the matching download button: Download PDF, Download PNG, or Download JPEG.
Note: PNG/JPEG export covers diagram canvas pages only — the additional appendices (BOMs, connection tables, etc.) are PDF-only.
7Bulk-export across a system
To export many diagrams and harnesses at once, or build a combined BOM, use the System Configuration dashboard (Tutorial 12: System Configuration & Versioning).
8Download released PDFs
Once an artifact has been released (Tutorial 12: System Configuration & Versioning), open the Releases section in Diagram Properties (or Harness Properties) and click the download icon on the release row.
9Export library data
In the Library sidebar header, click the funnel icon to open Advanced Library Search. Build a query, then click Download CSV. This reflects your organization's whole library, independent of any diagram. See Tutorial 4: Library Search Tools.
Summary
You generated BOM and Connections Table exports from a diagram or harness, produced a manufacturing Cut List from the harness editor, and exported polished drawings as PDF/PNG/JPEG with optional appendices. You also know where to find bulk export in the System Configuration dashboard and library CSV export in Advanced Library Search.
What's next
- → Tutorial 12: System Configuration & Versioning — the same BOM and export ideas across a whole system, plus release status, data completeness, and cross-diagram error checks.
- → Tutorial 19: Using the Artifact API — automate the same BOM, Connections Table, and netlist exports from scripts.
- → Tutorial 14: Linking Artifact to Onshape — push the harness wire table directly into Onshape's Wire and Cable tool and pull 3D-routed lengths back into Artifact.
