How to Split an Object in Onshape: A Step-by-Step Guide

How-to basics · Updated November 22, 2026

To split an object in Onshape, open the Part Studio, choose the Split feature, select the part and a plane, face, or surface that crosses it, then accept the preview. When both sides are retained, Onshape creates separate parts you can select, hide, or use in later features. The key is to use a splitting tool that actually intersects the solid.

What You’ll Need

  • An Onshape document with a Part Studio containing the solid part you want to divide. In Onshape, a solid object is usually called a part.
  • A splitting tool that crosses the part, such as a datum plane, a planar face, or a surface. If you need a custom cut location, create an appropriate plane or surface first.
  • Permission to edit the document. If it is shared read-only, ask for editing access or make an editable copy if the document owner allows it.

Step-by-Step

  1. Open the correct Part Studio. In the document tabs along the bottom, select the Part Studio that contains the part. Do not start in an Assembly: splitting is a Part Studio modeling operation. If the document has several studios, check the graphics area and Parts list to confirm you have the intended model.
  2. Decide where the split should go. Identify the location and direction of the cut before opening the feature. A plane crossing the middle of a block makes a simple two-piece split; a plane through an angled part can produce differently shaped pieces. If you are working from a drawing or a measured location, note the required offset or angle so you can define a suitable tool accurately.
  3. Create a splitting tool if needed. If an existing plane or face already passes through the part at the right location, use it. Otherwise, create a plane with the Plane feature, or create a surface that crosses the solid. For an offset plane, select suitable reference geometry and enter the required distance; for an angled plane, choose references that define the angle. Confirm that the new tool extends through the whole region you intend to divide. A sketch line alone is not generally a solid-splitting tool: use a surface or a suitable plane instead.
  4. Start the Split feature. In the Part Studio feature toolbar, click Split. The feature opens a dialog with selection fields. If you cannot see the command, check that you are in a Part Studio rather than an Assembly and look through the feature toolbar. The feature dialog will guide you to choose what to split and what geometry will do the splitting.
  5. Select the part to split. Click the part in the graphics area, or select its entry in the Parts list. If the field accepts multiple selections, add only the parts you intend to divide. Check the selection highlight and the dialog field before continuing: selecting a face or an edge when the feature expects a part can cause the selection to be rejected or produce an unintended result.
  6. Choose the splitting tool. Activate the dialog field for the splitting tool, then select the plane, planar face, or surface that should cut through the part. If the tool is difficult to pick in the model, select it from the feature tree or hide nearby geometry temporarily. The tool must cross the solid; touching the outside without passing through it will not divide the part into two regions.
  7. Review the preview and retention options. Inspect the preview from more than one viewing angle. If you need both pieces, enable the option to keep both sides, when shown. If you want only one side, use the available side-retention controls to keep the required region. Some Split dialogs also provide an option to keep the splitting tool; leave it on only if you want that tool to remain as a part. Check the Parts list and preview to confirm which geometry will remain.
  8. Accept the feature and verify the result. Click the green check mark to create the split. Onshape adds the feature to the feature list and updates the model. Select each resulting part in the Parts list to confirm that the pieces are separate. You can hide one piece to inspect the other, or rotate the view to check that the cut reaches the intended boundaries. If the result is wrong, edit or delete the Split feature, correct the tool or selections, and try again.

A practical example is dividing a rectangular block into a base and a cap. Create or use a plane at the desired height, start Split, select the block, and select that plane as the tool. Preview the cut with both sides retained, accept it, and check that two entries appear in the Parts list. You can then select either piece for downstream features without changing the original split location.

Common Mistakes

  • The tool does not pass through the part. A plane that stops at the outer surface, or sits just outside the solid, may not create a split. Extend or reposition the tool so it crosses the intended volume. For a curved or irregular part, verify the intersection around the whole area rather than judging from one view.
  • Selecting the wrong kind of geometry. The part selection field needs the solid part, while the splitting-tool field needs geometry that can divide it. If Onshape highlights an edge or face instead of the whole part, clear the field and select the correct item. Use the Parts list for the part and the feature tree for a plane or surface when the model is crowded.
  • Expecting a sketch line to cut a solid by itself. A sketch is useful for defining geometry, but a line on a sketch does not automatically act like a plane passing through a three-dimensional solid. Build a suitable surface or use a plane for splitting the part. If your aim is to divide a face boundary rather than separate a solid, use a face-splitting workflow instead.
  • Keeping only one side by accident. Inspect the preview and the side-retention settings before accepting the feature. If one half disappears, edit the Split feature and adjust the option or side selection. The feature history makes it possible to revise the operation without rebuilding the entire part.
  • Confusing a split with an assembly separation. A Split operation changes parts in a Part Studio; it does not automatically create an Assembly or arrange pieces apart. If you need to position the resulting parts relative to one another, create or update an Assembly after the split.

Tips

  • Name important tools and features. Rename a custom plane and the Split feature with descriptive names such as “Mid-height split.” Clear labels make the feature tree easier to understand when you return to the model or share it with a teammate.
  • Use the simplest tool that matches the cut. A standard plane is usually easier to adjust than a complicated surface. For a straight, flat division, prefer a plane or planar face; reserve a shaped surface for cuts that genuinely need a non-flat boundary.
  • Check the view from multiple directions. A preview that looks correct from the front can still miss a narrow section behind the visible face. Rotate the model, zoom in around the intersection, and check whether the tool crosses all of the intended material.
  • Keep the feature history editable. A Split feature that references an existing plane is generally easier to revise than an operation based on hard-to-identify geometry. If the desired cut location may change, define the plane from stable references and a clear offset.
  • Use visibility to inspect the result. Hide one resulting part in the Parts list, inspect the exposed cut, then show it again. This is a quick way to spot an incomplete cut, an unexpected retained side, or a small leftover region.
  • Distinguish splitting from trimming or cutting away material. Splitting is useful when you want separate part regions. If your goal is to remove material and leave a cavity, a feature such as Extrude with a remove operation may be more appropriate. Choose the feature based on the result you need, not just the shape of the cutting tool.

Troubleshooting

The Split feature reports an error or produces no visible change. First confirm that the selected part is a solid and that the selected tool intersects it. Move the tool through the part, extend the surface, or adjust the plane offset. Also make sure the active dialog field contains the intended selection. A tool that is merely tangent to the part may fail to create two distinct regions.

The preview shows the wrong region or only one piece. Reopen the feature and check the option for retaining both sides. If the feature lets you choose which side remains, change that choice and inspect the preview before accepting. If you need two usable pieces, verify that both are kept, rather than assuming the preview will retain them automatically.

The tool is hidden or hard to select. Expand the feature tree and select the plane or surface there, or hide parts that block access to it. You can also rotate the model to expose the tool. Avoid deleting the tool just to make the selection easier; it may be referenced by the Split feature and later edits.

The split succeeds but the pieces do not behave as expected. Check the Parts list to see whether Onshape created distinct parts and whether a small fragment was also produced. A tool crossing the part in an unexpected location can leave a sliver or divide the solid into more regions than intended. Edit the tool’s position and review the preview closely. If you intended to separate components in an Assembly, remember to create the Assembly and insert or position the new parts there.

The feature fails after an earlier edit. A change to a plane, surface, or upstream feature can remove or alter the geometry the Split references. Edit the Split dialog, reselect valid geometry, and confirm the preview. If a reference has disappeared, choose a more stable plane or face and update the feature. Work through failed features in order from the earliest error in the feature list, since later features may depend on the split.

Frequently Asked Questions

Does splitting a part create two separate parts in Onshape?

It can. If the tool divides the solid into distinct regions and you retain both sides, the Part Studio can contain separate parts. Confirm the result in the Parts list; the visible cut alone does not prove that both pieces were retained.

Can I split a part with a plane?

Yes. A plane is a common tool for a straight split. Select it in the Split feature after selecting the part, and ensure it passes through the solid. You can create a new plane at an offset or angle if the default planes do not match the desired cut.

Can I split a part with a curved surface?

A suitable surface can be used when a flat plane will not create the shape you need. The surface must intersect the solid in a way that divides it into valid regions. Preview the result carefully, as a complex surface can create small fragments or an unexpected boundary.

How do I keep both sides of the split?

In the Split dialog, look for the control that keeps both sides and enable it if available. Check the preview and Parts list after accepting. The exact options depend on the selected split operation, so use the visible preview rather than relying on a remembered default.

Can I undo or change a split later?

Yes. You can undo the most recent feature, or edit or delete the Split feature in the feature list. Editing is usually best if you want to keep the operation but change its tool, position, selected part, or retained side.

What is the difference between splitting a part and splitting a face?

Splitting a part divides a solid into separate part regions. Splitting a face changes how a face is divided without necessarily creating separate solid parts. Choose the operation that matches whether you need distinct pieces or only a new boundary on a surface.

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.