Part Box

From FreeCAD Documentation
Jump to navigation Jump to search
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎русский • ‎中文(中国大陆)‎ • ‎한국어
Next: Cylinder Part Cylinder.svg Arrow-right.svg

Part Box.svg Part Box

Menu location
Part → Primitives → Cube
Default shortcut
Introduced in version
See also
Part Primitives


The Box command from the Part Workbench inserts a parametric, rectangular cuboid, geometric primitive into the active document. By default, the Box command will insert a 10x10x10 mm cube, positioned at the origin, with the label "cube". These parameters may be modified after the object has been added.



  1. Switch to the Workbench Part.svg Part Workbench
  2. There are several ways to invoke the command:
    • Press the Part Box.svg Cube button in the toolbar.
    • Select the Part → Primitives → Part Box.svg Cube from the menu bar.

Result: The default result is a box with an equal length, width and height of 10 mm. It is attached to the global xy-plane and one edge is coincident with the global z-axis.

The box properties can later be edited, either in the property editor or by double-clicking on the box in the model tree.



  • DataLength: The length parameter is the Box's dimension in the x-direction.
  • DataWidth: The width parameter is the Box's dimension in the y-direction.
  • DataHeight: The height parameter is the Box's dimension in the z-direction.


A Part Box can be created using the following function:

box = FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
  • Where "myBox" is the name for the object.
  • The function returns the newly created object.

You can access and modify attributes of the box object. For example, you may wish to modify the length, width and height parameters.

box.Length = 25
box.Width = 15
box.Height = 30

You can change its placement with:

box.Placement = FreeCAD.Placement(FreeCAD.Vector(4, 6, 3), FreeCAD.Rotation(30, 45, 10))

Next: Cylinder Part Cylinder.svg Arrow-right.svg