# 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.

- Page: https://mendboxstudio.com/docs/image-per-instance/install
- Updated: 2026-11-16
- Publisher: Mendbox Studio (Dynamic Flower Unipessoal LDA, Portugal)

## 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](https://mendboxstudio.com/docs/image-per-instance/panel) 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](https://github.com/mendbox/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](https://mendboxstudio.com/docs/image-per-instance/panel) or the [workflows](https://mendboxstudio.com/docs/image-per-instance/workflows).

## Related

- Product page: [Image Per Instance](https://mendboxstudio.com/addons/image-per-instance)
- [Troubleshooting](https://mendboxstudio.com/docs/image-per-instance/troubleshooting)
- Guide: [different image per instance in Blender](https://mendboxstudio.com/guides/different-image-per-instance)

---
Source: https://mendboxstudio.com/docs/image-per-instance/install
