PartDesign Feature

From FreeCAD Documentation
Jump to navigation Jump to search
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎русский


A PartDesign Feature refers to a "step" in the modelling process that happens inside of a PartDesign Body. For example, each time you add a solid box with PartDesign AdditiveBox, you add a feature; when you add a chamfer to an edge with PartDesign Chamfer, you add another feature; when you cut a hole using a sketch and PartDesign Pocket, you add another feature.

PartDesign Feature example.png

Feature editing in a PartDesign Body with three sequential features.

There are many types of features which can add or remove volume from an initial solid. The word "feature" refers to the operation itself, and also to the resulting solid after that operation.

To learn more about creating solid objects with the PartDesign Workbench see feature editing.


Almost all tools in the PartDesign Workbench are meant to add features to a PartDesign Body. These tools can be accessed from the menu and toolbar buttons while an object or sub-element (vertex, edge, face) is selected.

The features can be placed in different categories:


FreeCAD core objects.svg

Simplified diagram of the relationships between the core objects in the program. The PartDesign::Feature objects are used to build parametric 3D solids, and thus are derived from the basic Part::Feature object.


See also: FreeCAD Scripting Basics, and scripted objects.

See Part Feature for the general information on adding objects from the Python console.

See PartDesign Body for the general information on adding a Body. Once a Body exists, features can be attached to it using the Body's addObject() method.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject('PartDesign::Body', 'Body')
obj.Label = "Custom label"

feature = App.ActiveDocument.addObject('PartDesign::AdditiveBox', 'Box')
feature.Width = 200
feature.Length = 300
feature.Height = 500

feature2 = App.ActiveDocument.addObject('PartDesign::SubtractiveBox', 'Box')
feature2.Width = 50
feature2.Length = 200
feature2.Height = 400