Installing more workbenches

Introduction
Since v0.17 it is easy to add external workbenches by using the Addon Manager. A regular user doesn't need to do more than use this tool.

Keep reading for more information regarding installation of workbenches.

General description
Workbenches are nothing more than collections of files that are placed in a folder. This folder is usually compressed into a zip archive. On installation, this folder is simply uncompressed and copied to

where is a top level directory searched by FreeCAD on startup. This is essentially what the Addon Manager does.

The directories are scanned every time FreeCAD is started, and the available workbenches are automatically added.

Installing system-wide
Workbenches installed in this way will be available to all users. Depending on your system, you might need administrator privileges to access the installation directory.

Copy the workbench folder into, where is the FreeCAD installation directory.
 * On Linux it is usually
 * On Windows it is usually
 * On macOS it is usually

Installing for a single user
Workbenches installed in this way will be available only to one user, but will not require any administrator privileges.

Copy the workbench folder into, where is the FreeCAD directory for a particular.
 * On Linux it is usually  or in  for previous versions.
 * On Windows it is, which is usually
 * On macOS it is usually . One way to get to the preferences directory is to use the "Finder" menu item, and entering.

Additional information
Additional information on how to create a custom workbench can be found in the Power users hub and the Developer hub.

See also a detailed description in the page how to install additional workbenches.