DocumentationSubstance 3DSubstance 3D Ecosystem User Guide

Downloading and Installing the Plugin

Last update: October 20, 2026

Download

To download the plugin, visit Substance 3D in Blender. Click Download the plugin to start the download.

You can also get the latest version directly from the links below.

There are two separate .zip files to download and install:

WARNING
For Mac users: Users should disable “open safe files after downloading” if they are downloading the Plugin with Safari.
Safari web browser defaults to unzipping downloaded .zip files, which need to remain zipped for installation. To prevent the file from unzipping, update Safari preferences to not open “safe” files after downloading.
  1. Open Safari
  2. Click Preferences
  3. Under the General tab, uncheck the option Open “safe” files after downloading.

Install Steps

First time installation

  1. Download the Plugin .zip files from the Adobe prerelease page.
  2. Open Blender (v. 3.0 or higher).
  3. From the top navigation bar, select Edit and then Preferences. Then select the Add-ons tab.
  4. Click the Install button.
  5. In the file explorer, locate the folder to where the .zip files were downloaded to
  6. Select the Substance3DInBlender.zip file and click the Install Add-on button.
  7. In the Add-ons section, click the checkbox to enable the add-on and click the drop-down arrow the expand the section.
  8. You will be prompted to install the Integration Tools. Click Install from disk to select the Substance3DIntegrationTools.zip and click the Install tools button.
    If they were not previously downloaded, click Download to open the Adobe prerelease page in your browser and download the tools, then use Install from disk to install them.
  9. The addon is now ready to use!

Updating the Plugin and Tools

  1. Download the newest release from the links above.
  2. Use the Uninstall Tools button to remove the Substance 3D Integration Tools.
  3. Use the Remove button to uninstall the add-on
  4. Close and restart Blender
  5. From the top navigation bar, select Edit and then Preferences. Then select the Add-ons tab.
  6. Click the Install button.
  7. In the file explorer, locate the newly downloaded ZIP files.
  8. Select the Substance3DInBlender.zip file and click the Install Add-on button.
  9. In the Add-ons section, click the checkbox to enable the add-on and click the drop-down arrow the expand the section.
  10. You will be prompted to install the Integration Tools. Click Install from disk to select the Substance3DIntegrationTools.zip and click the Install tools button.
    If they were not previously downloaded, click Download to open the Adobe prerelease page in your browser and download the tools, then use Install from disk to install them.
  11. The addon is now ready to use!

Updating Individual Components

When updating the Add-on only:

  1. From the add-on preferences, use the Remove button to uninstall the add-on.
  2. Restart Blender
  3. Navigate to the add-on preferences again and use the Install button to load the new version of the Plugin. The previously loaded Integration Tools will remain.

When updating the Integration Tools only:

  1. From the add-on preferences, use the Update Tools button to load the newer version of the Integration Tools. The previously used Add-on will remain.
  2. Restart Blender for changes to take effect.

OR

  1. From the add-on preferences use the Uninstall Tools button to remove the Integration Tools.
  2. Restart Blender
  3. Use the Install from disk button to find and load the newer version of the Integration Tools. The previously used Add-on will remain.
recommendation-more-help
substance-3d-help-substance-3d-integrations