Comprehensive Guide On How To Merge Parts In Onshape For Advanced Assemblies
Merging parts in Onshape is accomplished primarily through the Boolean tool, which combines multiple solid bodies into a single, unified part by performing union, subtraction, or intersection operations. This process is essential for streamlining complex parametric models, simplifying mass property calculations, and ensuring that exported geometry for manufacturing or 3D printing is geometrically contiguous.
Prerequisite Environment and Model Integrity Standards
Before initiating a Boolean merge operation in Onshape, you must ensure that your parts exist within the same Part Studio environment. Onshape maintains a strict hierarchy where assemblies and Part Studios serve distinct functional roles; you cannot merge individual instances within an Assembly tab. If your parts are currently in an assembly, you must either derive them into a single Part Studio or edit the part in context.
- Essential Software Requirements: An active Onshape professional or standard account with write permissions for the specific document.
- Technical Prerequisites: All target parts must be valid solid bodies (not surfaces) and must be geometrically overlapping or touching to form a manifold solid.
- Procedural Benchmarks: For complex assemblies with more than fifty parts, plan for a processing duration of approximately two to five minutes, depending on the complexity of the feature tree and topological intricacy.
- Geometric Validation: Verify that all bodies are calculated as solids in the Part List, indicated by the solid-cube icon rather than the translucent surface icon.
Procedural Execution for Merging Geometry
Step 1: Accessing the Boolean Tool
Navigate to the toolbar located at the top of the Part Studio interface. Locate the icon representing two overlapping circles; this is the Boolean feature. If you have customized your toolbar, it may be nested within the feature flyout menu that contains patterns and transformations. Selecting this tool will open a dialog box requiring two primary inputs: the tool mode and the target bodies.
Step 2: Configuring the Boolean Operation
Within the Boolean dialog box, select the Union option. This is the specific mode that combines the volumes of separate parts into one. You must then select the Tool bodies, which are the parts you intend to merge into the Target part.
Pro-Tip: If your parts are disconnected in space, the Union operation will fail unless you select the Keep Tools option. However, if you intend to create a single manufacturing part, ensure that the bodies physically overlap or contact one another to avoid creating non-manifold geometry, which often leads to errors in downstream simulation or additive manufacturing slicing software.
Step 3: Managing Tool Retention and Part Identity
Decide whether you wish to retain the original source parts or consume them into the new unified body. By default, Onshape will remove the Tool bodies and leave you with only the final merged part. If you toggle the Keep Tools checkbox, Onshape will generate the new unified part while maintaining the original parts as separate entities in your Part List.
Warning: Keeping tools unnecessarily can lead to duplicate geometry, which inflates model file size and can cause significant errors in mass property calculations, as the software will double-count the shared volume of the merged regions.
Step 4: Finalizing the Feature
Once the desired bodies are selected and the operation mode is verified, click the green checkmark to commit the feature to the history tree. Onshape will recompute the model, and the Parts List on the left sidebar will update to reflect the new, singular body. You should immediately verify the mass properties by selecting the new part and clicking the scale icon in the bottom right corner of the workspace to ensure the volume matches the expected cumulative total of the source components.
How can I join paths? — Onshape
Technical Parameters and Geometric Logic Table
The following table outlines the expected behavior of the Boolean operation based on the chosen mode and geometry intersection status.
| Boolean Mode | Required Geometry Status | Resultant Geometry | Typical Use Case |
|---|---|---|---|
| Union | Overlapping/Touching | Single unified solid body | Creating complex custom hardware |
| Subtract | Overlapping | Tool volume removed from Target | Creating mounting recesses or cuts |
| Intersect | Overlapping | Only overlapping volume remains | Creating mating interface profiles |
| Union (Non-Touching) | Separated in space | Multi-body single part (invalid) | Rare; usually indicates design error |
Common Failure Scenarios and Resolution Strategies
Field operators often encounter issues where the Boolean feature fails to execute. Identifying the root cause is critical to maintaining parametric integrity.
Non-Manifold Edge Errors
- Root Cause: Attempting to merge two parts that touch only along an infinitely thin edge or at a single point, resulting in a mathematical singularity that the Parasolid kernel cannot resolve as a manifold solid.
- Actionable Fix: Introduce a slight overlap or a small fillet between the components to ensure a finite surface area of contact, providing the solver with a clear transition boundary.
Tool-Target Selection Conflict
- Root Cause: Attempting to merge a part with itself or selecting a tool body that is hidden or excluded from the current computation state.
- Actionable Fix: Ensure both the tool and target bodies are fully visible in the Part Studio. Verify that there are no suppressed features preceding the Boolean operation that define the current shape of the parts.
Feature List Circular Dependency
- Root Cause: Placing a Boolean operation in the tree that references geometry created by a feature located after the Boolean itself in the sequence.
- Actionable Fix: Drag and drop the Boolean feature lower in the tree below the features that define the geometry of the target parts, or use the "Edit in Context" feature to push logic into the correct sequence.
Frequently Asked Questions
Can I merge parts that are in different documents?
No, you cannot directly merge parts across different documents using the Boolean tool. You must first use the Derive feature to import the parts from the secondary document into the current Part Studio before the Boolean operation becomes available for those bodies.
What happens if I move parts after the Boolean operation?
The Boolean operation is a static feature in the design history. If you move a part that was used as a tool in the Boolean operation, you must move it to a position that still satisfies the overlap requirement or the Boolean feature will fail to compute.
Is it possible to undo a Boolean merge after saving?
Yes, you can simply delete or suppress the Boolean feature in the feature tree. Because Onshape is a parametric, history-based modeler, removing the feature will revert the parts to their original, individual state without data loss.
Does the Boolean operation affect the appearance settings of the parts?
When you merge parts, the resulting body will inherit the appearance properties of the primary "Target" body by default. You can reassign colors or material textures to the new unified part in the Part List to override these defaults.
Mastering Boolean operations is a fundamental requirement for efficient CAD modeling in Onshape. Streamline your design process today by adopting these structured merge workflows to ensure your manufacturing files are always error-free.
