PartDesign SubShapeBinder

From FreeCAD Documentation
Jump to navigation Jump to search
Other languages:
English • ‎français • ‎italiano

PartDesign SubShapeBinder.svg PartDesign SubShapeBinder

Menu location
Part Design → Create a sub-object shape binder
Default shortcut
Introduced in version
See also
ShapeBinder, Clone


A PartDesign SubShapeBinder imports an element from another Body into the active Body. It can take the Shape of, or be "bound" to one or multiple objects or subelements (edges or faces) from another object.

Then the resulting binder object can moved or be used to perform advanced operations like booleans or pads.

It can also bind to objects that are nested inside Std Parts, and it will track the relative placement of these features. This is useful in the context of creating assemblies, as often the user needs to reference features that are already correctly placed in another subassembly.

PartDesign SubShapeBinder example 1.png PartDesign SubShapeBinder example 2.png

Left: two solids created in two separate bodies. Right: two SubShapeBinders extracted from the first body, imported into the second body, and moved to a different position.

PartDesign SubShapeBinder example 3.png

The two SubShapeBinders are used to create a boolean cut, and a pad, with the second body.


  1. Start with a PartDesign Body.svg Body already in place, containing a single feature, for example, an PartDesign AdditivePrism.svg AdditivePrism.
  2. Create a second PartDesign Body.svg Body, containing a single feature, for example, an PartDesign AdditiveBox.svg AdditiveBox. This will be the active body.
  3. Select the entire first body, the press PartDesign SubShapeBinder.svg SubShapeBinder.
  4. Modify the properties of this binder object, for example its placement.
  5. Use it with another operation, such as PartDesign Boolean.svg Boolean.


The SubShapeBinder is derived from Part Feature (Part::Feature class). In addition to the properties listed in Part Feature, the following properties are available in the property editor.



  • Data (hidden)Support (XLinkSubList): support for the geometry.
  • DataFuse (Bool): if it is True it will fuse the solid linked shapes.
  • DataMake Face (Bool): if it is True it will created a face for the linked wires.
  • DataClaim Children (PropertyBool): if it is True it will claim the linked objects as children in the tree view.
  • DataRelative (Bool): if it is True it will enable relative sub-object linking.
  • DataBind Mode (Enumeration): binding mode, Synchronized, Frozen, Detached.
  • DataPartial Load (Bool): if it is True it will enable partial loading of the objects.
  • Data (hidden)Context (XLink): container object of this binder object.
  • Data (hidden)_Version (Integer): version of this type of object.
  • Data (hidden)Shape (PartShape): Part TopoShape of this object.


  • Data (hidden)Body (Matrix): unity matrix of this object.


See Part Feature.