Onshape Combine Parts Into One: Boolean Union Guide

How-to basics · Updated November 22, 2026

Yes. In Onshape, use the Boolean feature with its operation set to Union to combine selected parts in a Part Studio into one part. The parts should touch or overlap if you need one continuous solid; if you only want several pieces treated as a group without fusing their geometry, use a different approach, such as a composite part or an assembly rigid group.

What combining parts means in Onshape

Onshape distinguishes between parts that are geometrically fused and components that are merely organized or constrained together. A Boolean Union changes the model’s geometry: it combines the selected solid parts and removes the internal boundaries where their volumes intersect. The intended result is one part rather than several separate parts in the Part Studio.

That distinction matters because “make these parts one” can describe different design goals. A bracket and a reinforcing rib that are meant to be manufactured as one piece are good candidates for a Boolean union. Two panels that should remain separate for assembly, replacement, or motion generally should not be fused. Combining geometry can affect downstream drawings, manufacturing operations, part lists, and how a model is exported.

  • Boolean Union: fuses selected solid geometry into a part.
  • Composite part: groups parts as a composite without replacing the underlying pieces with a single fused solid.
  • Assembly rigid group: keeps assembly components as separate parts but constrains them to move together.

How to use Boolean Union

Boolean is a Part Studio feature. The parts you want to combine need to be available in the same Part Studio; parts sitting in an Assembly are not selected directly for a Part Studio Boolean. If the geometry is in different Part Studios, bring the needed geometry into one Part Studio first, for example with a Derived feature, then create the union there.

  1. Open the Part Studio containing the solid parts. Confirm that the parts are present in the feature history and positioned as intended.
  2. Click Boolean in the Part Studio feature toolbar.
  3. In the feature dialog, set the operation to Union.
  4. Select the parts to merge in the graphics area or from the part list. Check that every intended part is included.
  5. Decide whether to use Keep tools. Leave it off when you want the input parts consumed by the Boolean result; turn it on when you need to retain the source parts as separate geometry as well.
  6. Preview the result, then accept the feature with the green check mark. If the feature reports an error, inspect the contact between the parts and the feature’s selections.

Onshape records the Boolean in the Part Studio feature list, so it remains an editable step rather than an irreversible change to the original model history. You can edit the feature later to change its selections or operation, suppress it, or investigate whether an earlier feature caused a problem. The exact result still depends on the geometry created by the earlier features.

Do the parts have to touch?

For a dependable single, connected solid, the parts should touch or overlap. If one part ends just short of another, a Boolean does not create a bridge across the gap; the gap remains a design issue. A union of separated geometry may fail or produce a result that is not useful as one connected solid, depending on the geometry and how it is handled by downstream operations. Do not rely on Union to close a gap automatically.

For example, imagine a cylindrical boss intended to sit on a plate. If the bottom of the boss slightly penetrates the plate, the overlapping volumes give the union a clear connection. If the boss floats a fraction of a millimeter above the plate, the model does not describe a fused boss and plate. Edit the sketch, extrusion depth, or placement so the solids meet as intended, then rebuild the Boolean.

Touching exactly at a face or edge can also be less robust than a small, intentional overlap, especially when later edits introduce tiny edges or nearly coincident faces. The appropriate geometry depends on the design: do not add overlap where it would alter a required dimension or create an unwanted internal feature. The goal is a valid, deliberate connection, not simply a feature that happens to compute.

When to choose Union, Composite part, or an assembly

Choose the method based on what “one” means for the finished design. Union is the right choice when the intended object is a single continuous solid. It removes the separate-part distinction at the fused region, which is useful for a one-piece molded, machined, or printed design. It is not the right way to represent components that need to remain individually selectable or that move relative to one another.

A composite part is useful when several parts should be handled as a combined item while their individual geometry remains represented. It can suit a collection of pieces that belong together but should not become one fused volume. It does not make separated components physically continuous, and it is not a substitute for a Boolean when you need a solid suitable for an operation that expects one connected body.

In an Assembly, use an appropriate mate or a rigid group when separate components should stay fixed relative to each other. A rigid group is about component relationships and motion, not about merging surfaces. The components remain separate parts, which is usually important for assemblies with fasteners, replaceable pieces, or separate manufacturing processes.

  • Use Union for geometry designed to become one solid.
  • Use a composite part when you need a grouped representation but want to preserve the pieces as constituent parts.
  • Use an Assembly and rigid group when parts remain separate components but should move together.

What Keep tools changes

Keep tools controls whether the original selected parts remain available alongside the Boolean result. If you leave it off, the inputs are consumed into the feature result in the Part Studio’s displayed model. If you enable it, the source geometry is retained as well as the union result. This can be useful when you want to compare the fused part with its inputs or preserve them for another modeling purpose.

Keeping the tools does not mean the union result is a group of separate parts. It means the feature retains the input parts in addition to creating its result. Those retained parts can overlap the result, so visibility and later selections may need attention. If the goal is simply one final part, keeping the tools is usually unnecessary. If you enable it for an alternate design or reference, make sure you understand which parts are visible and which parts are included in any export.

Common errors and ways to diagnose them

A failed Boolean does not necessarily mean Union is the wrong feature. Often the issue is a selection mistake, invalid or ambiguous geometry, or an unintended gap. Start by checking the preview and the selected parts rather than rebuilding the whole Part Studio.

  • A part is missing from the result: Check the Boolean’s selected-parts field. A part that exists in the Part Studio is not automatically included unless selected.
  • The union fails after a model edit: Inspect the changed sketch, face, or feature for a gap, self-intersection, or very small sliver of geometry. A small change can make previously valid faces coincide in a problematic way.
  • The parts look connected but remain separate: Zoom in and inspect the contact. They may be visually close without actually touching, or may meet only along a fragile edge.
  • The result includes unwanted geometry: Review the selection and the Keep tools setting. Also check whether a source part was already hidden or retained by an earlier feature.
  • A downstream feature fails: Edit the Boolean and inspect the resulting faces and edges. Fillets, shells, and other operations can be sensitive to tiny edges or complex intersections created by a union.

Use feature history to locate the earliest step that produces invalid geometry. If the Boolean worked before a later edit, temporarily suppress or edit nearby features to determine whether the problem is in the Boolean itself or in a change to its inputs. Avoid using increasingly complex downstream features to conceal a basic gap or incorrect overlap.

Exporting, drawings, and manufacturing implications

After a successful union, check the Part Studio’s part list and the result in the graphics area to confirm that the intended output is one part. Then consider what the receiving workflow expects. A one-piece print or machining setup may benefit from a fused solid, while a bill of materials for an assembly usually needs its components to remain distinct. A Boolean changes the model’s part structure, so it can change what is available as an individual item in drawings or assembly workflows.

For 3D printing, a continuous solid is often the intended export, but do not treat the word “union” as a guarantee that every slicer or export format will interpret every model identically. Check the selected part and inspect the exported file in the target application. If you retained tools, be particularly careful not to export both the union and overlapping source parts by mistake; duplicate overlapping geometry can create confusing results.

For manufacturing drawings, decide whether the drawing should describe one fused part or an assembly of separate items. If the pieces are welded, bonded, or fastened together in the real design, a fused model may not communicate those manufacturing details by itself. A model’s geometry and the documented manufacturing process are related, but they are not always the same thing.

Frequently Asked Questions

Can I combine parts from two Onshape Part Studios?
Not directly with one Boolean feature while they remain in separate Part Studios. Bring the needed geometry into a common Part Studio, such as with a Derived feature, and then use Boolean Union.

Can I combine components that are already in an Assembly?
Boolean is a Part Studio feature, not an Assembly command for fusing assembly components. If you need one solid, create or bring the geometry into a Part Studio and union it there. If the components should remain separate, use assembly relationships instead.

Does Boolean Union preserve the original parts?
Use the Keep tools option if you need the source parts retained alongside the result. Without it, the selected inputs are consumed into the Boolean result in the Part Studio’s feature outcome.

Will Union connect parts that are separated by a gap?
No. Union does not add material to bridge a gap. Make the parts touch or overlap as intended, or model a connecting feature before creating the union.

Is a composite part the same as a Boolean union?
No. Union fuses geometry into a solid result. A composite part groups constituent parts without the same geometric fusion, so it is more appropriate when you want to treat pieces together but retain their separate identities.

Why would I keep parts separate instead?
Keep them separate when they are independently manufactured, replaceable, fastened, or movable, or when an assembly bill of materials needs to list them individually. A rigid group can make separate assembly components move together without turning them into one solid.

Related

Try it: the Date Difference Calculator: days, months, years and weekdays between two dates, with the DATEDIF formulas.

More in How-to basics

Sources: Function behaviour and menu paths: Microsoft Support documentation for Excel. Method & sources

Spotted an error in this guide? Let us know.