Installation#
Download and install Blender
Blender is a free and open-source program for 3D authoring. It works on Linux, Mac, and Windows. It is developed by the Blender community.
Tip
No administrator rights on Windows? Choose the “Portable .zip” option when downloading from the Blender website.
Download the BlenderBIM Add-on
The BlenderBIM Add-on extends Blender with OpenBIM related capabilities.
Warning
If you are not using Blender version >=3.1, please follow the Unstable installation instructions. Read more
Install the BlenderBIM Add-on
Open up Blender, and click on
Edit > Preferences
.Select the Add-ons tab, and press Install… on the top right. Navigate to the .zip you downloaded in Step 2, and press Install Add-on.
Warning
You do not need to unzip the add-on file. You should install it as a zipped file.
You should now see Import-Export: BlenderBIM available in your add-ons list. Enable the add-on by pressing the checkbox.
All done! If you check your Scene properties in the panel on the bottom right, you will see a panel to manage your IFC Project.

You can enable add-ons permanently by using Save User Settings
from the Addons menu.
See also
If you are a poweruser, you may be interested in the Unstable installation to help with testing. Read more
Where is the add-on installed?#
Upon installation, the BlenderBIM Add-on is stored in the
scripts/addons/blenderbim/
directory, within your Blender configuration
folder. However, the location of your Blender configuration folder depends on
how you have installed Blender.
If you downloaded Blender as a .zip
file without running an installer, you
will find the Blender configuration folder in the following directory, where
X.XX
is the Blender version:
/path/to/blender/X.XX/
Otherwise, if you installed Blender using an installation package, the Blender configuration folder depends on which operating system you use.
On Linux, if you are installing the add-on as a user:
~/.config/blender/X.XX/
On Linux, if you are deploying the add-on system-wide (this may also depend on your Linux distribution):
/usr/share/blender/X.XX/
On Mac, if you are installing the add-on as a user:
/Users/{YOUR_USER}/Library/Application Support/Blender/X.XX/
On Mac, if you are deploying the add-on system-wide:
/Library/Application Support/Blender/X.XX/
On Windows:
C:\Users\{YOUR_USER}\AppData\Roaming\Blender Foundation\X.XX\
Updating#
First uninstall the current BlenderBIM add-on, then install the latest version.
Uninstalling#
Navigate to Edit > Preferences > Add-ons
. Due to a limitation in Blender,
you have to first disable the BlenderBIM Add-on in your Blender preferences by
pressing the checkbox next to the add-on, then restart Blender. After
restarting, you can uninstall the BlenderBIM Add-on by pressing the Remove
button in the Blender preferences window.
Alternatively, you may uninstall manually by deleting the blenderbim/
directory in your Blender add-ons directory.
Warning
It is important to follow the sequence of disabling, restarting, then removing. If you do not restart Blender, the add-on will fail to remove correctly, and you will need to uninstall manually.
FAQ#
I get an error similar to “ImportError: IfcOpenShell not built for ‘linux/64bit/python3.7’”
Check which BlenderBIM Add-on build you are using. The zip will have either
py37
,py39
, orpy310
in the name. See the instructions in the Unstable installation section to check that you have installed the correct version.I am on Ubuntu and get an error similar to “ImportError: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found”
Our latest package which uses IfcOpenShell v0.7.0 is built using Ubuntu 20 LTS. If you have an older Ubuntu version, you can either upgrade to 19.10 or above, or you’ll need to compile IfcOpenShell yourself.
I get an error saying “ModuleNotFoundError: No module named ‘numpy’””
If you have installed Blender from another source instead of from Blender.org, such as from your distro’s package repositories, then you may be missing some modules like
numpy
. Try installing it manually likeapt install python-numpy
.Some other error prevents me from installing or doing basic functions with the add-on. Is it specific to my environment?
Sometimes it is helpful to try installing and using the BlenderBIM Add-on on a “clean environment”. A clean environment is defined as a fresh Blender installation with no other add-ons enabled with factory settings.
To quickly test in a clean environment, find your Blender configuration folder based on the where is the add-on installed section. Rename the folder from
X.XX
to something else likeX.XX_backup
, then restart Blender and try follow the installation instructions again.If this fixes your issue, consider disabling other add-ons one by one until you find a conflict as a next step to isolating the issue.
I get an error similar to RuntimeError: Instance #1234 not found
Blender saves and loads projects to a
.blend
file. However. the BlenderBIM Add-on works with native IFC, and this means instead of saving and loading.blend
files, you should instead save and load the.ifc
project.If you have opened a
.blend
file, there is a risk that the contents of the.blend
session do not correlate to the contents of the.ifc
, which can cause this error. Unless you are an advanced user, only save and load.ifc
files.