Install Image Per Instance in Blender
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
- Download the zip from Gumroad or Superhive. Do not unzip it.
- In Blender open Edit > Preferences > Get Extensions.
- Open the arrow menu at the top right and choose Install from Disk.
- 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.
| Feature | Lite | Full |
|---|---|---|
| Build Atlas from a folder, Apply To Selected Objects | yes | yes |
| One shared material | yes | yes |
| Images per atlas | up to 20 | no limit in the add-on |
| Natural file order | yes | yes |
| Geometry Nodes instances, Array modifier | no | yes |
| Shuffle | no | yes |
| Tile shape and fit modes | no | yes |
| Assign by number, name or picker | no | yes |
| Alpha and emission | no | yes |
| Mapping without UVs | no | yes |
| Animation | no | yes |
| Random variation | no | yes |
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.
Related
- Product page: Image Per Instance
- Troubleshooting
- Guide: different image per instance in Blender