Assembly App in an Altium 365 Workspace

Created: September 26, 2022 | Updated: February 23, 2023
All Contents

Parent page: Workspace Projects

The Assembly App feature in an Altium 365 Workspace provides a browser-based project assembly tool which is based on advanced interaction between the project's detailed BOM data and its 2D/3D assembly view. By bringing these two related sources of assembly data together, the Assembly App delivers an integrated tool that allows assemblers to check and work through the board assembly process from one convenient location.

For those checking a board's assembly prior to manufacture or engaged in the process of manually assembling boards (say, for prototypes or a short run), the Assembly tool provides the required set of graphical and component part information for stepping through the assembly process. This avoids the need for traditional, and potentially error-prone, assembly processes such as manually checking between assembly and BOM printout sheets. To further assist in avoiding manual UI actions during the assembly process, the BOM Assembly tool also offers a full set of shortcut keys for its assembly process actions.

Assembly App Access

In an Altium 365 Workspace the interactive Assembly App feature is available from the WIP view of a specific project, or from the Design Snapshot view of a project Release. Choose the Assembly option in the navigation tree to open the Assembly App in its interactive preview mode, and then at any time, invoke the assembly process mode from the button.

Access the interactive Assembly BOM view from an opened project or a project Release. Hover over the image to see the active assembly process view.Access the interactive Assembly BOM view from an opened project or a project Release. Hover over the image to see the active assembly process view.

If an ActiveBOM document is not available in the current project then BOM data is derived from the design source documents. Adding a fully configured BOM document to your project is highly recommended however, as it delivers a rich information dataset to the Assembly process such as current manufacturer Part Choices and Supplier data (component pricing, availability, lifecycle status, etc).

Assembly Navigation

The Assembly App is comprised of a configurable BOM listing pane on the left and an interactive 2D/3D graphical view of the board assembly view on the right. Select any element in the pane or board assembly view to cross-probe between the two, which provides immediate visual interaction between BOM component parts and their physical board placement. In effect, the Assembly App's board/BOM navigation is equivalent to that provided through the project Design view, except that the cross-probe interaction is available from within a single page view rather than between the design view's PCB/3D/BOM mode tabs.

Select an entry row in the BOM listing pane to highlight all of its included components (as indicated by the Designator cell entries) in the assembly view, or select an individual designator to highlight just that component. As you navigate through the BOM assembly elements, the board assembly graphics will pan and zoom when highlighting a selected component (or components) and also flip to the other side of the board where required.

As shown in the below animation, when a selected BOM row includes components fitted to the other side of the board, these are highlighted in a row sublist that includes a Top/Bottom side information note – select this sub entry to cross-probe to the components on the other side of the board, which then populate the selected row entry (highlighted in blue). Use Top/Bottom tabs to manually flip the board view, and the R keyboard shortcut to reset the graphics view.

Dynamically cross probe between the BOM pane entries and the board Assembly display by selecting components individually or by group.

List and View Options

How BOM entries are listed and the Assembly graphics display can be configured from the button menu at the top of the BOM pane. The options include:


  • Group by component – Set the BOM entry rows to include groups of the same component (default), or when unchecked, assign a BOM row to individual components.

  • Split by side – Separate the BOM listing into Top and Bottom -side sections, where each section includes components placed on that board side. When unchecked (default), top and bottom side components are included together, but separated as a sub-entry when the row is selected – see Assembly Navigation, above.


  • Assembled – Show component 3D bodies (default), therefore visualizing the assembled board, or only show the component positions when unchecked. Applies to 3D mode only.
  • 3D – Show the board assembly graphics in 3D (default) or in 2D when unchecked.

The Assembly App's BOM entries and board graphics represent the currently selected project design Variant. Use the drop-down menu associated with the project name (at the top of the page) to choose a different design Variant..

Assembly Process Flow

Invoke the Assembly App's tracked assembly process mode from the button. In this mode, each BOM entry can sequentially be checked off (marked as done) as the assembly process proceeds, which provides a convenient audited version of the BOM that tracks the board assembly progress. Note that a set of selectable progress command options and keyboard shortcuts are displayed at the bottom of the BOM pane.

Step through the interactive assembly process by marking component BOM entries as done or skipped.Step through the interactive assembly process by marking component BOM entries as done or skipped.

As each BOM entry is selected you are free to navigate through its constituent components to determine their exact board location and orientation (see Assembly Navigation, above) – in this mode, components initially are highlighted by board position rather than as 3D bodies. When you have finished checking or fitting those component parts, the BOM entry can be toggled to a completed status by selecting (spacebar). The checked-off components are then shown as full 3D bodies (not available in 2D view mode), the assembly process automatically moves to the next BOM entry, and the completed entry is indicated by green designator text and a status marker. Note that you can revert the status of a completed BOM entry by selecting it and clicking its button.

While the assembly process steps through sequentially, you can select any BOM entry in the list to deal with that particular component part. A BOM entry also may be specifically bypassed by selecting Skip (escape key), which will mark that entry accordingly – note that the assembly process cannot be completed if entries are marked with a Skipped status or no status.

  • The top of the BOM pane includes a count of assembled (completed) components and a representative progress bar.
  • The component count on the Top and Bottom view tabs will show their respective number of components remaining to be marked as Done.
  • The assembly process can be restarted at any time by refreshing the Assembly App page (F5).

Full BOM information for the currently selected component(s) is available from the Information pane on the right, which is opened by the Show info command (or I keyboard shortcut). The Information pane is populated by component data drawn from the source documents or from an ActiveBOM document, if available. The latter option provides full and current data for the selected components(s) including lifecycle status, manufacturer part choices, and supplier pricing and availability. Note that as shown in the below animation, the components displayed for a BOM entry that has been checked off (marked as Done) are displayed as 3D bodies.

Enable the Information pane to see detailed BOM data for the currently selected component. The visual placement display of a component marked as Done changes to its 3D body graphic.

When all BOM entries have been marked as done and the assembly process is complete, this is reported in the status section at the bottom of the BOM pane along with the number of placed component pins and the elapsed time of the assembly process. To restart the assembly process, use the button to reset the Assembly App to its initial state.

A completed assembly process where all BOM entries have been marked as Done. The BOM pane includes relevant status information.A completed assembly process where all BOM entries have been marked as Done. The BOM pane includes relevant status information.

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: