Image Per Instance documentation

Install Image Per Instance in Blender

How to install, find, update and remove the Image Per Instance add-on in Blender 4.2 and newer, and how the free Lite version differs from the full one.

Requirements

Blender 4.2 or newer. The add-on is distributed as an extension zip. It has no external dependencies, needs no internet connection and installs no extra software.

Install from disk

  1. Download the zip from Gumroad or Superhive. Do not unzip it.
  2. In Blender open Edit > Preferences > Get Extensions.
  3. Open the arrow menu at the top right and choose Install from Disk.
  4. Pick the zip file.

Where the panel is

Hover over the 3D viewport and press N to open the sidebar. The add-on has its own tab named Image Per Instance. The panel inside it is called Image Per Instance, and the version number is shown at the bottom, for example Image Per Instance v0.2.0.

Four sub-panels sit below the main buttons and start collapsed: Choose Images Yourself, Material, Animate and Random Variation. The panel reference describes all of them.

Update

Install the newer zip with Install from Disk in the same way. Check the version at the bottom of the panel afterwards. Pressing Build Atlas again keeps each object's picture when the file names are the same.

Uninstall

Open Edit > Preferences > Get Extensions, find the add-on in the list and remove it. What the add-on created in your file is ordinary Blender data: the material IPI_Material, the atlas image IPI_Atlas, a custom property img_index on separate objects, and a modifier named IPI Assign Index on instance hosts. You can delete these by hand if you no longer need them.

Lite versus full

The free Image Per Instance Lite is a separate download. Its tab is named Image Per Instance Lite.

FeatureLiteFull
Build Atlas from a folder, Apply To Selected Objectsyesyes
One shared materialyesyes
Images per atlasup to 20no limit in the add-on
Natural file orderyesyes
Geometry Nodes instances, Array modifiernoyes
Shufflenoyes
Tile shape and fit modesnoyes
Assign by number, name or pickernoyes
Alpha and emissionnoyes
Mapping without UVsnoyes
Animationnoyes
Random variationnoyes

When Lite finds more than 20 images, it stops with the message "This free version supports up to 20 images".

Next: the panel reference or the workflows.

Image Per Instance documentation
Previous page
Image Per Instance panel reference
Next page