Where Does FreeCAD Store Config and Macros?
FreeCAD user.cfg and system.cfg config files on Windows, macOS and Linux, plus the macros folder.
Last updated
FreeCAD stores preferences in user.cfg with system paths in system.cfg, inside a FreeCAD data folder in the OS app-data location. Macros sit in a Macro subfolder.
Config paths drifted across FreeCAD versions (dotfolder versus XDG on Linux), so check both legacy spots when migrating old installs.
Where FreeCAD stores this, by platform
%APPDATA%\FreeCAD
Holds user.cfg, system.cfg and the Macro folder. Close FreeCAD before editing or resetting. Rename user.cfg to reset preferences safely.
~/.config/FreeCAD
Same filenames. Older Linux builds used ~/.FreeCAD instead; check both when migrating.
~/Library/Preferences/FreeCAD
Same role. Use Go to Folder in Finder. Macro folder travels with the same parent.
Frequently asked questions
How do I reset FreeCAD preferences?
Delete (or rename) user.cfg with FreeCAD closed. It regenerates with defaults on next launch. Back up the original first so custom toolbars are recoverable.
Where are FreeCAD macros stored?
Macros live in the Macro folder next to the configs. Copy the whole FreeCAD data folder to migrate macros, preferences and workbench settings together.
Notice an outdated path? Let us know.