FreeCAD 1.1.x UI click map
Summary¶
This article is a version-locked UI click map for FreeCAD 1.1.x. It documents exact menu paths, dialog names, toolbar locations, and keyboard shortcuts for every operation used in libdrone modelling. When FreeCAD changes its UI in a future release, only this article needs updating — all geometry articles and the FreeCAD skeleton document remain valid because they reference operations by name, not by click path.
Use this article alongside the FreeCAD skeleton document. The skeleton tells you what to do. This article tells you exactly where to click to do it.
Verified against: FreeCAD 1.1 stable (all platforms). macOS primary.
Concept¶
Reference¶
Screen layout — FreeCAD 1.1¶
┌─────────────────────────────────────────────────────────┐
│ Menu bar: File Edit View Tools [Workbench menus] │
│ Toolbar row 1: [Workbench dropdown] [tool icons] │
├──────────────┬──────────────────────────────────────────┤
│ │ │
│ Model Tree │ 3D Viewport │
│ (left panel)│ (centre) │
│ │ │
│ Tasks panel │ │
│ (appears │ │
│ below tree │ │
│ during ops) │ │
├──────────────┴──────────────────────────────────────────┤
│ Status bar: coordinates / solver state / snap info │
└─────────────────────────────────────────────────────────┘
The Workbench dropdown is in the top toolbar, left side. In FreeCAD 1.1 it may show as a text label or an icon depending on your toolbar configuration. If you cannot find it: View → Toolbars → Workbench → enable.
A — First-time preferences¶
Set navigation style¶
Edit → Preferences → Display → Navigation (tab)
Navigation style: CAD
Orbit style: Rounded Arcball (default in 1.1 — leave as is, or change to Trackball)
☑ Zoom at cursor
Click OK
⚠ FreeCAD 1.1 introduced Rounded Arcball as the default orbit style. If you opened Preferences and see Rounded Arcball already selected — this is correct for 1.1. The Cookbook was written against an earlier default. CAD navigation style still applies; only the orbit sub-style changed.
Set units¶
Edit → Preferences → General → Units (tab)
Unit system: Standard (mm/kg/s)
Number of decimals: 3
Click OK
B — Macros¶
Find macro folder (do this first — path varies by OS and install method)¶
Tools → Macros
Read the "Macro path:" shown at the top of the dialog
This is where to copy .FCMacro files
Close
| OS / install | Typical path |
|---|---|
| macOS | ~/Library/Preferences/FreeCAD/Macro/ |
| Linux native | ~/.FreeCAD/Macro/ |
| Linux Flatpak 1.0 | ~/.var/app/org.freecad.FreeCAD/data/FreeCAD/Macro/ |
| Linux Flatpak 1.1 | ~/.var/app/org.freecad.FreeCAD/data/FreeCAD/1.1/Macro/ (may vary — confirm via dialog) |
| Windows | %APPDATA%\FreeCAD\Macro\ |
Run a macro¶
Tools → Macros
Select macro name from list
Click Execute
First-time Flatpak filesystem access (Linux only — run once in terminal)¶
bash
flatpak override org.freecad.FreeCAD --filesystem=home
C — Documents¶
New document¶
File → New (Ctrl+N)
Save / Save As¶
File → Save Ctrl+S
File → Save As Ctrl+Shift+S
File → Save a Copy (use before major edits — creates a restore point)
⚠ FreeCAD has no autosave. Ctrl+S regularly. Save a Copy before any session where you will make significant structural changes to the model.
D — Workbench switching¶
Workbench dropdown (top toolbar) → select workbench name
| Workbench | Used for |
|---|---|
| Spreadsheet | Creating and editing the Variables spreadsheet |
| Part Design | All solid modelling |
| Assembly | Fit verification and interference checking |
Switching workbench does not close or lose current work.
E — Spreadsheet workbench¶
Create a spreadsheet¶
Workbench → Spreadsheet
Spreadsheet menu → Create Spreadsheet
Model Tree: right-click "Spreadsheet" → Rename → type: Variables → Enter
Double-click Variables to open the grid
Set an alias on a cell¶
Right-click the cell (column B) → Properties
Alias field: type the variable name exactly (case-sensitive)
Click OK
Reference a variable in a sketch dimension¶
Type exactly: =Variables.VariableName Example: =Variables.ArmWidth
The prefix Variables. is always required. No # prefix (that was the Variables file notation — FreeCAD uses the spreadsheet name as prefix).
F — Part Design workbench — bodies¶
Create a new Body¶
Workbench → Part Design
Part Design menu → Body → Create Body
(alternative: Model menu → Body → Create Body)
Model Tree: right-click the new Body → Rename → type name → Enter
The active Body is shown in bold in the Model Tree. All features you create next belong to this Body.
Activate a different Body (if you have multiple)¶
Model Tree: double-click the Body to activate it
G — Part Design workbench — datum planes¶
Create a datum plane¶
Part Design menu → Datum → Create a Datum Plane
(alternative: Part Design toolbar → datum plane icon)
In the Attachment dialog: Select a reference (base plane, face, or another datum plane) Attachment mode: choose mode (Flat Face, XY/XZ/YZ Plane, etc.) Offset: type value in Z field to move the plane outward Click OK
After creating: rename immediately in the Model Tree.
Model Tree: right-click datum plane → Rename → type descriptive name → Enter
Example: DatumPlane_MotorHead, DatumPlane_RodTop
H — Sketcher — creating sketches¶
Create a sketch on a base plane¶
Model Tree: click the plane to select it (XY_Plane, XZ_Plane, or YZ_Plane)
Sketch menu → New Sketch
(alternative: Part Design toolbar → New Sketch icon)
Sketcher opens. Grid and axes appear in viewport.
Create a sketch on a datum plane¶
Model Tree: click the datum plane to select it Sketch menu → New Sketch FreeCAD offers to use the selected plane → click OK
Create a sketch on a face (use sparingly — topological naming risk)¶
Viewport: click the face to select it
Sketch menu → New Sketch
FreeCAD offers to use the selected face → click OK
Prefer datum planes over face references wherever possible.
Close a sketch¶
Sketcher Tasks panel (left): click Close button
(alternative: press Escape)
(alternative: Sketch menu → Close Sketch)
I — Sketcher — geometry tools¶
Rectangle (centred)¶
Sketcher menu → Sketcher Geometries → Create Rectangle
In the dropdown next to the tool: select Centered Rectangle
Click once at origin (0,0) → move mouse → click to set approximate size
Circle¶
Sketcher menu → Sketcher Geometries → Create Circle
Click centre point → move mouse → click to set approximate radius
Sketch fillet (rounds 2D corners)¶
Sketcher menu → Sketcher Geometries → Create Fillet
Click a corner point (where two lines meet)
Type radius value in the Tasks panel → Enter
Repeat for each corner
This is a 2D sketch fillet — different from Part Design 3D Fillet.
Line¶
Sketcher menu → Sketcher Geometries → Create Line
Click start point → click end point → right-click to stop
J — Sketcher — constraints¶
Dimension (generic — applies horizontal, vertical, or angular automatically)¶
Sketcher menu → Sketcher Constraints → Constrain internal angle
(or press D in Sketcher for dimension shortcut)
Click the element to constrain
Type value or formula in dialog → OK
Horizontal distance (X distance between two points)¶
Sketcher menu → Sketcher Constraints → Constrain Horizontal Distance
Click element or two points
Type value or =Variables.Name → OK
Vertical distance (Y distance between two points)¶
Sketcher menu → Sketcher Constraints → Constrain Vertical Distance
Click element or two points
Type value or =Variables.Name → OK
Coincident (two points or a point and origin share position)¶
Select two points (Ctrl+click both)
Sketcher menu → Sketcher Constraints → Constrain Coincident
(alternative: press C)
Fully constrained check¶
A fully constrained sketch shows all elements green. Status bar at bottom shows: Fully constrained
White or yellow elements are under-constrained — add more dimensions or constraints until all turn green before closing the sketch.
K — Part Design — features¶
Pad (push sketch into 3D)¶
Model Tree: click the sketch to select it
Part Design menu → Additive → Pad
(alternative: Part Design toolbar → Pad icon)
In Pad dialog:
Type: Dimension
Length: type value or =Variables.Name
Symmetric: leave unchecked (pad in one direction only)
Reversed: check if solid appears on wrong side
Click OK
Pocket (remove material)¶
Model Tree: click the sketch to select it Part Design menu → Subtractive → Pocket
In Pocket dialog: Type: Through All (for channels and holes that go full depth) — or — Type: Dimension → type depth value Reversed: check if cutting in wrong direction Click OK
Additive Loft (blend between two profiles)¶
Part Design menu → Additive → Additive Loft
In Loft dialog:
Profile section → Add Section → click first sketch
Add Section again → click second sketch
Closed: unchecked
Ruled: unchecked (smooth blend)
Click OK
The two sketches must be on parallel planes at different positions.
Part Design Fillet (rounds 3D edges)¶
Select edge(s) in viewport (Ctrl+click for multiple edges)
Part Design menu → Fillet
Size: type radius value
Click OK
This is the 3D edge fillet — different from Sketcher 2D fillet.
Part Design Chamfer¶
Select edge(s) in viewport
Part Design menu → Chamfer
Size: type chamfer size
Click OK
L — Fixing broken features¶
Yellow warning triangle in Model Tree¶
Model Tree: click the warned feature
Tasks panel: read what reference was lost
Re-select the lost reference (face, edge, datum plane) in the viewport
Click OK
This is the topological naming problem. It is normal. It is always fixable. Do not delete and recreate — re-select the reference.
Sketch solver messages¶
While in Sketcher:
Sketch menu → Sketcher Preferences → General
Solver messages: set to Full / Verbose
M — Assembly workbench¶
Create an assembly¶
Workbench → Assembly
Assembly menu → Create Assembly
(alternative: Assembly toolbar → Create Assembly icon)
Model Tree: rename the assembly container
Insert a component (Body) into the assembly¶
Assembly menu → Insert Component
Navigate to the Body → select → Insert
(alternative: drag a Body from the Model Tree into the Assembly container)
Create a fixed joint (anchors first part to world origin)¶
Assembly menu → New Joint → Fixed Joint
Select the Body to fix
Click OK
Create a coincident joint (face-to-face flush)¶
Assembly menu → New Joint → Coincident
Select first face → select second face
Click OK
Solve assembly (applies all joints)¶
Assembly menu → Solve Assembly
Interference check¶
Tools menu → Part → Check Geometry → Check for Intersections
Section cut view¶
View menu → Standard Views → Section Cut
Select plane: XY / XZ / YZ
Adjust Z offset slider to desired height
N — STL export¶
Export a single Body as STL¶
Model Tree: right-click the Body → Export Mesh
(alternative: select Body → File → Export)
In export dialog:
Format: STL Mesh
Units: mm ← verify — not inches
Deviation: 0.01 mm
Click Save
O — Viewport navigation (CAD style)¶
| Action | Input |
|---|---|
| Rotate | Middle mouse button + drag |
| Pan | Middle mouse button + Ctrl + drag |
| Zoom | Scroll wheel |
| Fit all | V then F |
| Look at selected face | Select face → Numpad 0 |
| Front view | Numpad 1 |
| Top view | Numpad 7 |
| Toggle selected item visibility | Spacebar |
P — Essential keyboard shortcuts¶
| Shortcut | Action |
|---|---|
| Ctrl+S | Save |
| Ctrl+Z | Undo |
| Ctrl+Y | Redo |
| V, F | Fit all to view |
| Spacebar | Toggle selected item visibility |
| Escape | Exit current tool / close sketch |
| D | (Sketcher only) Dimension constraint |
| C | (Sketcher only) Coincident constraint |
| H | (Sketcher only) Horizontal constraint |
| V | (Sketcher only) Vertical constraint |
| P | (Sketcher only) Point on object constraint |
Q — Common mistakes and fixes¶
| Mistake | Symptom | Fix |
|---|---|---|
| Sketch not closed | Pad/Pocket grayed out or fails | Open sketch → look for gaps at corners → close gap → re-close sketch |
| Under-constrained sketch | White/yellow elements in sketch | Add dimensions/constraints until all elements green |
| Topological naming failure | Yellow triangle in Model Tree | Click warned feature → re-select lost reference → OK |
| Sketch fillet vs Part Design fillet confusion | Wrong tool, unexpected result | 2D corners in sketch → Sketcher Fillet. 3D edges on finished solid → Part Design Fillet |
| Pad in wrong direction | Solid appears on wrong side | Check Reversed in Pad dialog |
| Variable reference not found | Dimension shows red / sketch broken | Verify prefix: =Variables.Name — check spelling and case |
| Wrong Body active | Feature added to wrong Body | Model Tree: double-click correct Body to activate it |
| STL exported in inches | Part 25.4× too large in slicer | Re-export: verify Units = mm in export dialog |
| Multiple Bodies, operations bleed across | Features appear in wrong Body | Always check which Body is bold (active) before creating features |
Procedure¶
Rationale¶
Why a separate UI article rather than UI steps in each geometry article¶
FreeCAD changes its menu structure, dialog names, and toolbar layouts between releases. If UI clicks are embedded in geometry articles, every FreeCAD update requires hunting through all affected articles to find and correct the stale paths — typically while mid-build and under time pressure.
Isolating UI paths here means a FreeCAD release that moves a menu item requires updating one article. All geometry articles and the skeleton document remain unchanged. The versioning (freecad-ui-110, freecad-ui-120) makes it clear which UI map applies and when a new one is needed.
Why this is version-locked to 1.1.x¶
FreeCAD 1.0 shipped the Assembly workbench built-in. FreeCAD 1.1 changed the default orbit style to Rounded Arcball and refined the Assembly joint workflow. Future versions may move menus further. Each major UI change that affects libdrone modelling steps warrants a new article. Minor patch releases within 1.1.x are covered here unless they introduce breaking UI changes.
Connections¶
requires: [] related: - freecad-document-setup - freecad-workbenches - parametric-modelling-philosophy leads_to: - freecad-document-setup - variable-table-structure