<== Return to Documents

----------------------------------------- (Blender) Installing Python Addons -----------------------------------------

This page is intended to help you install Python-based addons with Blender.


To install any add-on, you have two main approaches: 1) Click the 'install' button in the add-ons section of the User Preferences, navigate to the downloaded .zip file, and then select it for installing. 2) Manually move the Python add-on files into the local data directory specified below. Once the files are in the correct place, then Blender should be able to find them. - If you installed the addon with method 1, then the addon should appear in the list right away. - If you installed the addon with method 2, then the addon should appear after Blender has been started, following the movement of files.


1) Make sure you are using a version of Blender that is supported by the addon. (The addon developer should provide this information.) 2) Make sure you have the latest version of Python installed on your computer. (External features have a heavily reliance on the Python language.)


The addon developer will either provide a link to a .zip file, a single Python file, or an uncompressed folder that contains a collection of files (including .py and/or .pyc files).


Blender will detect Python extension files from the local data path. -------------------------------------------------------------------------------- Windows: %USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.80\ Example: C:\Users\{USER}\AppData\Roaming\Blender Foundation\Blender\2.80\scripts\addons -------------------------------------------------------------------------------- macOS: /Users/$USER/Library/Application Support/Blender/2.80/ -------------------------------------------------------------------------------- Linux: $HOME/.config/blender/2.80/ -------------------------------------------------------------------------------- On Blender's startup, it will read the appropriate addon/scripts folder for Python extensions. You will be able to browse these by going to: Edit -> User Preferences In the User Preferences, there will be a section for 'Add-ons'. This section of the User Preferences contains a list of all of the extensions available with the installed build of Blender. Some useful extensions come pre-packaged with the software. You can choose to show user-made add-ons by using the 'Community' filter. Once you have installed a new add-on, it will appear in this list. You can find it easily by using the search bar.